Shape

Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podržava dodavanje geometrijskih oblika i tekstualnih okvira u radne listove putem ShapeCollection (ws.shapes). Svaki oblik je predstavljen kao Shape objekat sa konfigurisanim svojstvima popunjavanja, linije i teksta.

: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType je IntEnum koji identifikuje tip geometrijskog oblika.


`UNKNOWN`	0	`TEXT_BOX`	21
`RECTANGLE`	1	`CALLOUT`	22
`ROUNDED_RECTANGLE`	2	`PENTAGON`	23
`OVAL`	3	`CLOUD`	24
`DIAMOND`	4	`HEART`	25
`TRIANGLE`	5	`LIGHTNING_BOLT`	26
`RIGHT_TRIANGLE`	6	`SMILEY_FACE`	27
`PARALLELOGRAM`	7	`LEFT_RIGHT_ARROW`	28
`TRAPEZOID`	8	`UP_DOWN_ARROW`	29
`HEXAGON`	9	`CUBE`	30
`OCTAGON`	10	`BEVEL`	31
`CROSS`	11	`STAR_4`	12
`RIGHT_ARROW`	17	`STAR_5`	13
`LEFT_ARROW`	18	`STAR_6`	14
`UP_ARROW`	19	`STAR_7`	15
`DOWN_ARROW`	20	`STAR_8`	16

FillType

FillType je IntEnum koji identifikuje tip popunjavanja primenjenog na oblik.


`NONE`	0
`SOLID`	1
`GRADIENT`	2
`PATTERN`	3
`AUTOMATIC`	4

MsoLineDashStyle

MsoLineDashStyle je IntEnum za šablon isprekidane linije ivice/okvira.


`SOLID`	0
`DASH`	1
`DOT`	2
`DASH_DOT`	3
`DASH_DOT_DOT`	4
`LONG_DASH`	5
`LONG_DASH_DOT`	6

TextAlignmentType

TextAlignmentType je IntEnum za horizontalno poravnanje teksta unutar oblika.


`LEFT`	0
`CENTER`	1
`RIGHT`	2
`JUSTIFY`	3
`DISTRIBUTED`	4

TextAnchorType

TextAnchorType je IntEnum za vertikalno sidrenje teksta unutar oblika.


`TOP`	0
`MIDDLE`	1
`BOTTOM`	2
`JUSTIFIED`	3

MsoFillFormat

Upravlja izgledom popunjavanja oblika. Pristupa se putem shape.fill.


`fill_type`	`FillType`	Aktivni tip popunjavanja.
`fore_color`	`str`	Boja popunjavanja u prvom planu (primarna) u RRGGBB heks formatu.
`transparency`	`float`	Neprozirnost popunjavanja kao vrednost od `0.0` (potpuno neprozirno) do `1.0` (potpuno prozirno).

copy

fill.copy() -> MsoFillFormat

Vraća duboku kopiju ovih postavki popunjavanja.

MsoLineFormat

Upravlja izgledom konture/ivice oblika. Pristupa se putem shape.line.


`is_visible`	`bool`	`True` za crtanje konture oblika.
`color`	`str`	Boja konture u RRGGBB heks formatu.
`weight`	`int`	Debljina konture (debljina) u tačkama.
`dash_style`	`MsoLineDashStyle`	Šablon crtice za konturu.
`transparency`	`float`	Neprozirnost konture od `0.0` (neprovidan) do `1.0` (transparentan).

copy

line.copy() -> MsoLineFormat

Vraća duboku kopiju ovih postavki linije.

ShapeFont

Upravlja fontom teksta unutar oblika. Dostupno putem shape.font.


`name`	`str`	Naziv porodice fonta (npr., `"Calibri"`).
`size`	`float`	Veličina fonta u tačkama.
`bold`	`bool`	`True` za podebljani stil.
`italic`	`bool`	`True` za kurzivni stil.
`underline`	`bool`	`True` za jednostruko podvlačenje.
`color`	`str`	Boja fonta kao RRGGBB heks.

copy

font.copy() -> ShapeFont

Vraća duboku kopiju ovih postavki fonta.

Shape objekti se ne konstrušu direktno. Koristite ws.shapes.add(...) ili ws.shapes.add_text_box(...).


`name`	`str`	Čitanje/Upis	Naziv oblika (mora biti jedinstven unutar radnog lista).
`drawing_type`	`MsoDrawingType`		Geometrijski tip ovog oblika.
`upper_left_row`	`int`	Čitanje/Upis	0-based row index of the top-left anchor cell.
`upper_left_column`	`int`	Čitanje/Pisanje	0-based column index of the top-left anchor cell.
`lower_right_row`	`int`	Čitanje/Pisanje	0-based row index of the bottom-right anchor cell.
`lower_right_column`	`int`	Čitanje/Pisanje	0-based column index of the bottom-right anchor cell.
`upper_left_row_offset`	`int`	Čitanje/Pisanje	Piksel pomeraj od gornjeg ruba gornje leve ćelije.
`upper_left_column_offset`	`int`	Čitanje/Pisanje	Piksel pomeraj od levog ruba gornje leve ćelije.
`lower_right_row_offset`	`int`	Čitanje/Pisanje	Piksel pomak od gornjeg ruba donje desne ćelije.
`lower_right_column_offset`	`int`	Čitanje/Pisanje	Piksel pomak od levog ruba donje desne ćelije.
`fill`	`MsoFillFormat`		Podešavanja popunjavanja (pozadine).
`line`	`MsoLineFormat`		Podešavanja konture/ivice.
`text`	`str`	Čitanje/Pisanje	Tekstualni sadržaj prikazan unutar oblika.
`font`	`ShapeFont`		Podešavanja fonta za tekst oblika.
`text_horizontal_alignment`	`TextAlignmentType`	Čitanje/Pisanje	Horizontalno poravnanje teksta unutar oblika.
`text_vertical_alignment`	`TextAnchorType`	Čitanje/Pisanje	Vertikalno usidravanje teksta unutar oblika.
`is_text_wrapped`	`bool`	Čitanje/Pisanje	`True` za prelamanje teksta na granici oblika.
`is_locked`	`bool`	Čitanje/Pisanje	`True` za zaključavanje oblika kada je zaštita radnog lista aktivna.
`is_hidden`	`bool`	Čitanje/Pisanje	`True` da sakrije oblik.
`hyperlink`	`str	None`	Čitanje/Pisanje

copy

shape.copy() -> Shape

Vraća duboku kopiju ovog oblika sa svim očuvanim formatiranjem.

ShapeCollection

ShapeCollection se pristupa kao ws.shapes. Sadrži sve oblike na radnom listu.

add

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

Dodaje oblik navedenog tipa. Svi argumenti položaja su indeksirani od 0 za red/kolonu.

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

Prečica za add(MsoDrawingType.TEXT_BOX, ...).

Svojstva i iteracija


`count`	Broj oblika u kolekciji (samo za čitanje).
`__len__()`	`count`.
`__iter__()`	Iterira kroz sve `Shape` objekte.
`__getitem__(index)`	Vraća `Shape` na nultom indeksu `index`.

Dodaj pravougaonik sa jednobojnim popunjavanjem

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

Dodaj tekstualni okvir

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

Shape — Aspose.Cells FOSS for Python API Reference

MsoDrawingType

FillType

MsoLineDashStyle

TextAlignmentType

TextAnchorType

MsoFillFormat

copy

MsoLineFormat

copy

ShapeFont

copy

copy

ShapeCollection

add

add_text_box

Svojstva i iteracija

Dodaj pravougaonik sa jednobojnim popunjavanjem

Dodaj tekstualni okvir

Vidi i