Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss stöder att lägga till geometriska former och textrutor i kalkylblad genom den ShapeCollection (ws.shapes). Varje form representeras av en Shape objekt med konfigurerbara fyllnings-, linje- och textegenskaper.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType är en IntEnum som identifierar den geometriska formtypen.

FillType

FillType är en IntEnum som identifierar typen av fyllning som tillämpas på en form.

MsoLineDashStyle

MsoLineDashStyle är en IntEnum för kant-/konturlinjens streckmönster.

TextAlignmentType

TextAlignmentType är en IntEnum för horisontell textjustering inom en form.

TextAnchorType

TextAnchorType är en IntEnum för vertikal textförankring inom en form.

MsoFillFormat

Styr fyllningsutseendet för en form. Åtkomst via shape.fill.

ImageRenderOptions

ImageRenderOptions

copy

fill.copy() -> MsoFillFormat

Returnerar en djup kopia av dessa fyllningsinställningar.

MsoLineFormat

Kontrollerar kontur-/kantutseendet för en form. Åtkomst via shape.line.

ImageRenderOptions

ImageRenderOptions

copy

line.copy() -> MsoLineFormat

Returnerar en djup kopia av dessa linjeinställningar.

ShapeFont

Styr textens teckensnitt inom en form. Åtkomst via shape.font.

ImageRenderOptions

ImageRenderOptions

copy

font.copy() -> ShapeFont

Returnerar en djup kopia av dessa teckensnittinställningar.

ImageRenderOptions

Shape objekt konstrueras inte direkt. Använd ws.shapes.add(...) eller ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

copy

shape.copy() -> Shape

Returnerar en djup kopia av denna form med all formatering bevarad.

ShapeCollection

ShapeCollection åtkomst sker som ws.shapes. Den innehåller alla figurer på ett kalkylblad.

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

Lägger till en form av den angivna typen. Alla positionsargument är 0-baserade rad-/kolumnindex.

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

Genväg för add(MsoDrawingType.TEXT_BOX, ...).

Egenskaper och iteration

ImageRenderOptions

Lägg till en rektangel med solid fyllning

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")

Lägg till en textruta

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")

Se även

• Cells Python API-referens hem
• Workbook-klassreferens
• Referens för Worksheet‑klassen
• Diagramreferens
• Komma igång