Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podporuje pridávanie geometrických tvarov a textových polí do pracovných hárkov prostredníctvom ShapeCollection (ws.shapes). Každý tvar je reprezentovaný Shape objektom s konfigurovateľnými vlastnosťami výplne, čiary a textu.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType je IntEnum identifikujúcim typ geometrického tvaru.

FillType

FillType je IntEnum identifikujúcim typ výplne aplikovanej na tvar.

MsoLineDashStyle

MsoLineDashStyle je IntEnum pre vzor prerušenej čiary okraja/obrysu.

TextAlignmentType

TextAlignmentType je IntEnum pre vodorovné zarovnanie textu v tvare.

TextAnchorType

TextAnchorType je IntEnum pre vertikálne ukotvenie textu v tvare.

MsoFillFormat

Ovláda vzhľad výplne tvaru. Prístupné cez shape.fill.

ImageRenderOptions

ImageRenderOptions

copy

fill.copy() -> MsoFillFormat

Vráti hlbokú kópiu týchto nastavení výplne.

MsoLineFormat

Ovláda vzhľad obrysu/okraja tvaru. Prístupné cez shape.line.

ImageRenderOptions

ImageRenderOptions

copy

line.copy() -> MsoLineFormat

Vráti hlbokú kópiu týchto nastavení čiary.

ShapeFont

Ovláda písmo textu v tvare. Prístupné cez shape.font.

ImageRenderOptions

ImageRenderOptions

copy

font.copy() -> ShapeFont

Vráti hlbokú kópiu týchto nastavení písma.

ImageRenderOptions

Shape objekty sa nekonštruujú priamo. Použite ws.shapes.add(...) alebo ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

copy

shape.copy() -> Shape

Vráti hlbokú kópiu tohto tvaru so všetkým zachovaným formátovaním.

ShapeCollection

ShapeCollection sa pristupuje ako ws.shapes. Obsahuje všetky tvary na hárku.

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

Pridá tvar zadaného typu. Všetky argumenty polohy sú indexy riadkov/stĺpcov začínajúce od 0.

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

Skratka pre add(MsoDrawingType.TEXT_BOX, ...).

Vlastnosti a iterácia

ImageRenderOptions

Pridať obdĺžnik s plnou výplňou

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

Pridať textové pole

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

Pozri tiež

• Cells Python API Referencia domov
• Referenčný popis triedy Workbook
• Referenčný materiál triedy Worksheet
• Odkaz na graf
• Začíname