Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss ondersteunt het toevoegen van geometrische vormen en tekstvakken aan werkbladen via de ShapeCollection (ws.shapes). Elke vorm wordt weergegeven door een Shape object met configureerbare vul-, lijn- en teksteigenschappen.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    MsoDrawingType, FillType, MsoLineDashStyle,
    TextAlignmentType, TextAnchorType,
    MsoFillFormat, MsoLineFormat, ShapeFont, Shape,
)

MsoDrawingType

MsoDrawingType is een IntEnum die het type geometrische vorm identificeert.

FillType

FillType is een IntEnum die het type vulling identificeert dat op een vorm wordt toegepast.

MsoLineDashStyle

MsoLineDashStyle is een IntEnum voor het streepjespatroon van de rand-/omtreklijn.

TextAlignmentType

TextAlignmentType is een IntEnum voor horizontale tekstuitlijning binnen een vorm.

TextAnchorType

TextAnchorType is een IntEnum voor verticale tekstverankering binnen een vorm.

MsoFillFormat

Regelt het vulverschijnsel van een vorm. Toegankelijk via shape.fill.

ImageRenderOptions

ImageRenderOptions

kopiëren

fill.copy() -> MsoFillFormat

Retourneert een diepe kopie van deze vulinstellingen.

MsoLineFormat

Regelt het uiterlijk van de omtrek/rand van een vorm. Toegankelijk via shape.line.

ImageRenderOptions

ImageRenderOptions

kopiëren

line.copy() -> MsoLineFormat

Retourneert een diepe kopie van deze lijninstellingen.

ShapeFont

Beheert het lettertype van de tekst binnen een vorm. Toegankelijk via shape.font.

ImageRenderOptions

ImageRenderOptions

kopiëren

font.copy() -> ShapeFont

Retourneert een diepe kopie van deze lettertype‑instellingen.

ImageRenderOptions

Shape objecten worden niet direct geconstrueerd. Gebruik ws.shapes.add(...) of ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopiëren

shape.copy() -> Shape

Retourneert een diepe kopie van deze vorm met alle opmaak behouden.

ShapeCollection

ShapeCollection wordt benaderd als ws.shapes. Het bevat alle vormen op een werkblad.

ImageRenderOptions

add

ws.shapes.add(
    drawing_type: MsoDrawingType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

Voegt een vorm van het opgegeven type toe. Alle positie‑argumenten zijn 0‑gebaseerde rij/kolom‑indexen.

add_text_box

ws.shapes.add_text_box(
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

Snelkoppeling voor add(MsoDrawingType.TEXT_BOX, ...).

Eigenschappen en iteratie

ImageRenderOptions

Voeg een rechthoek toe met effen vulling

from aspose.cells_foss import Workbook, MsoDrawingType, FillType, MsoLineDashStyle, TextAlignmentType

wb = Workbook()
ws = wb.worksheets[0]

# Add a blue rectangle spanning rows 1-5, columns 1-4 (0-based)
rect = ws.shapes.add(MsoDrawingType.RECTANGLE, 1, 1, 5, 4)
rect.name = "BlueBox"

rect.fill.fill_type = FillType.SOLID
rect.fill.fore_color = "4472C4"      # blue
rect.fill.transparency = 0.0

rect.line.is_visible = True
rect.line.color = "1F3864"           # dark blue
rect.line.weight = 2
rect.line.dash_style = MsoLineDashStyle.SOLID

rect.text = "Sales Summary"
rect.font.bold = True
rect.font.color = "FFFFFF"           # white text
rect.font.size = 12
rect.text_horizontal_alignment = TextAlignmentType.CENTER

wb.save("shapes.xlsx")

Voeg een tekstvak toe

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

tb = ws.shapes.add_text_box(2, 0, 5, 3)
tb.name = "NoteBox"
tb.text = "Review this section before publishing."
tb.font.italic = True
tb.font.color = "595959"
tb.is_text_wrapped = True
tb.line.is_visible = True
tb.line.color = "BFBFBF"

wb.save("textbox.xlsx")

Zie ook

• Cells Python API-referentie home
• Workbook-klasse referentie
• Werkblad klasse referentie
• Grafiekreferentie
• Aan de slag