Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss støtter å legge til geometriske former og tekstbokser i regneark gjennom the ShapeCollection (ws.shapes). Hver form er representert av en Shape objekt med konfigurerbare fyll-, linje- og tekstegenskaper.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType er en IntEnum som identifiserer den geometriske formtypen.

FillType

FillType er en IntEnum som identifiserer typen fyll som er brukt på en form.

MsoLineDashStyle

MsoLineDashStyle er en IntEnum for kant-/omrisslinjens stiplemønster.

TextAlignmentType

TextAlignmentType er en IntEnum for horisontal tekstjustering innenfor en form.

TextAnchorType

TextAnchorType er en IntEnum for vertikal tekstforankring innenfor en form.

MsoFillFormat

Styrer fyllutseendet til en form. Tilgjengelig via shape.fill.

ImageRenderOptions

ImageRenderOptions

kopi

fill.copy() -> MsoFillFormat

Returnerer en dyp kopi av disse fyllinnstillingene.

MsoLineFormat

Styrer kontur-/kantutseendet til en form. Tilgjengelig via shape.line.

ImageRenderOptions

ImageRenderOptions

kopi

line.copy() -> MsoLineFormat

Returnerer en dyp kopi av disse linjeinnstillingene.

ShapeFont

Styrer tekstskriften innenfor en figur. Tilgjengelig via shape.font.

ImageRenderOptions

ImageRenderOptions

kopi

font.copy() -> ShapeFont

Returnerer en dyp kopi av disse fontinnstillingene.

ImageRenderOptions

Shape objekter konstrueres ikke direkte. Bruk ws.shapes.add(...) eller ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopi

shape.copy() -> Shape

Returnerer en dyp kopi av denne formen med all formatering bevart.

ShapeCollection

ShapeCollection tilgås som ws.shapes. Den inneholder alle figurer på et regneark.

ImageRenderOptions

legg til

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

Legger til en form av den angitte typen. Alle posisjonsargumenter er 0-baserte rad-/kolonneindekser.

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

Snarvei for add(MsoDrawingType.TEXT_BOX, ...).

Egenskaper og iterasjon

ImageRenderOptions

Legg til et rektangel med solid fyll

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

Legg til en tekstboks

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 også

• Cells Python API-referanse hjem
• Workbook-klasse referanse
• Referanse til Worksheet-klassen
• Diagramreferanse
• Kom i gang