Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss atbalsta ģeometrisko formu un teksta lodziņu pievienošanu darblapām caur ShapeCollection (ws.shapes). Katra forma tiek pārstāvēta kā Shape objekts ar konfigurējamiem aizpildījuma, līnijas un teksta īpašībām.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType ir IntEnum kas identificē ģeometriskās formas veidu.

FillType

FillType ir IntEnum kas identificē uz formas piemērotā aizpildījuma veidu.

MsoLineDashStyle

MsoLineDashStyle ir IntEnum kas nosaka robežas/kontūras līnijas pārtraukuma modeli.

TextAlignmentType

TextAlignmentType ir IntEnum kas nosaka horizontālo teksta līdzināšanu formas iekšienē.

TextAnchorType

TextAnchorType ir IntEnum kas nosaka vertikālo teksta piestiprināšanu formas iekšienē.

MsoFillFormat

Kontrolē formas aizpildījuma izskatu. Piekļūst caur shape.fill.

ImageRenderOptions

ImageRenderOptions

kopēt

fill.copy() -> MsoFillFormat

Atgriež dziļu kopiju šiem aizpildījuma iestatījumiem.

MsoLineFormat

Kontrolē formas kontūras/robežas izskatu. Piekļūst caur shape.line.

ImageRenderOptions

ImageRenderOptions

kopēt

line.copy() -> MsoLineFormat

Atgriež dziļu kopiju šiem līnijas iestatījumiem.

ShapeFont

Kontrolē teksta fontu formā. Piekļūst caur shape.font.

ImageRenderOptions

ImageRenderOptions

kopēt

font.copy() -> ShapeFont

Atgriež dziļu kopiju šiem fonta iestatījumiem.

ImageRenderOptions

Shape objekti netiek konstruēti tieši. Izmantojiet ws.shapes.add(...) vai ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopēt

shape.copy() -> Shape

Atgriež dziļu kopiju šim objektam, saglabājot visu formatējumu.

ShapeCollection

ShapeCollection tiek piekļūts kā ws.shapes. Tas satur visas formas darblapā.

ImageRenderOptions

pievienot

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

Pievieno objektu norādītā tipa. Visi pozīcijas argumenti ir 0‑bāzes rindu/kolonnas indeksi.

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

Īsceļš uz add(MsoDrawingType.TEXT_BOX, ...).

Īpašības un iterācija

ImageRenderOptions

Pievienot taisnstūri ar viendabīgu aizpildījumu

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

Pievienot teksta lodziņu

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

Skatīt arī

• Cells Python API atsauce sākums
• Workbook klases atsauce
• Darblapas klases atsauce
• Diagrammas atsauce
• Iepazīšanās