Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss tukee geometristen muotojen ja tekstilaatikoiden lisäämistä laskentataulukoihin kautta ShapeCollection (ws.shapes). Jokainen muoto esitetään Shape objektina, jossa on konfiguroitavat täyttö-, viiva- ja tekstiominaisuudet.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType on IntEnum tunniste, joka määrittää geometrisen muodon tyypin.

FillType

FillType on IntEnum tunniste, joka määrittää muotoon sovelletun täyttötyypin.

MsoLineDashStyle

MsoLineDashStyle on IntEnum rajaviivan / ääriviivan katkoviivan mallille.

TextAlignmentType

TextAlignmentType on IntEnum vaakasuoran tekstin tasausmuotoa muodon sisällä.

TextAnchorType

TextAnchorType on IntEnum pystysuoran tekstin ankkurointia muodon sisällä.

MsoFillFormat

Ohjaa muodon täytön ulkoasua. Käytettävissä kautta shape.fill.

ColladaSaveOptions

ColladaSaveOptions

copy

fill.copy() -> MsoFillFormat

Palauttaa syvän kopion näistä täyttöasetuksista.

MsoLineFormat

Säätää muodon ääriviivan/rajauksen ulkonäköä. Saadaan käyttöön kautta shape.line.

ColladaSaveOptions

ColladaSaveOptions

copy

line.copy() -> MsoLineFormat

Palauttaa syvän kopion näistä viiva-asetuksista.

ShapeFont

Säätää muodon sisällä olevaa tekstifonttia. Käytettävissä kautta shape.font.

ColladaSaveOptions

ColladaSaveOptions

copy

font.copy() -> ShapeFont

Palauttaa syvän kopion näistä fonttiasetuksista.

ColladaSaveOptions

Shape objekteja ei rakenneta suoraan. Käytä ws.shapes.add(...) tai ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptions

copy

shape.copy() -> Shape

Palauttaa syvän kopion tästä muodosta, säilyttäen kaikki muotoilut.

ShapeCollection

ShapeCollection kutsutaan ws.shapes. Se sisältää kaikki taulukon muodot.

ColladaSaveOptions

add

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

Lisää määritetyn tyyppisen muodon. Kaikki sijaintiargumentit ovat nollapohjaisia rivi‑/sarakeindeksejä.

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

Pikakuvake add(MsoDrawingType.TEXT_BOX, ...).

Ominaisuudet ja iteraatio

ColladaSaveOptions

Lisää suorakulmio, jossa on tasainen täyttö

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

Lisää tekstiruutu

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

Katso myös

• Cells Python API Reference etusivu
• Workbook-luokan viite
• Worksheet-luokan viite
• Kaavion viite
• Aloitus