Aspose.Cells FOSS
Python
Shape

Shape

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.

NameTypeAccessDescription
upper_left_row``Read/WriteGets or sets the upper left row.
upper_left_column``Read/WriteGets or sets the upper left column.
lower_right_row``Read/WriteGets or sets the lower right row.
lower_right_column``Read/WriteGets or sets the lower right column.
upper_left_row_offset``Read/WriteGets or sets the upper left row offset.
upper_left_column_offset``Read/WriteGets or sets the upper left column offset.
lower_right_row_offset``Read/WriteGets or sets the lower right row offset.
lower_right_column_offset``Read/WriteGets or sets the lower right column offset.
name``ReadGets the name.
drawing_type``ReadGets the drawing type.
fill``ReadGets the fill.
line``ReadGets the line.
text``ReadGets the text.
font``ReadGets the font.
text_horizontal_alignment``ReadGets the text horizontal alignment.
text_vertical_alignment``ReadGets the text vertical alignment.
is_text_wrapped``ReadGets the is text wrapped.
is_locked``ReadGets the is locked.
is_hidden``ReadGets the is hidden.
placement``ReadGets the placement.
hyperlink``ReadGets the hyperlink.

FillType

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

SignatureDescription
__init__(drawing_type, upper_left_row, upper_left_column, lower_right_row, lower_right_column)
copy()Creates a duplicate of the shape object

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ž

 Slovenčina