Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podržava dodavanje geometrijskih oblika i tekstualnih okvira u radne listove putem the ShapeCollection (ws.shapes). Svaki oblik predstavlja Shape objekt s konfigurabilnim svojstvima ispune, linije i teksta.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType je IntEnum koja identificira vrstu geometrijskog oblika.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
UNKNOWN0TEXT_BOX21
RECTANGLE1CALLOUT22
ROUNDED_RECTANGLE2PENTAGON23
OVAL3CLOUD24
DIAMOND4HEART25
TRIANGLE5LIGHTNING_BOLT26
RIGHT_TRIANGLE6SMILEY_FACE27
PARALLELOGRAM7LEFT_RIGHT_ARROW28
TRAPEZOID8UP_DOWN_ARROW29
HEXAGON9CUBE30
OCTAGON10BEVEL31
CROSS11STAR_412
RIGHT_ARROW17STAR_513
LEFT_ARROW18STAR_614
UP_ARROW19STAR_715
DOWN_ARROW20STAR_816

FillType

FillType je IntEnum koja identificira vrstu ispune primijenjene na oblik.

ColladaSaveOptionsColladaSaveOptions
NONE0
SOLID1
GRADIENT2
PATTERN3
AUTOMATIC4

MsoLineDashStyle

MsoLineDashStyle je IntEnum za uzorak crtice rubne/obrisne linije.

ColladaSaveOptionsColladaSaveOptions
SOLID0
DASH1
DOT2
DASH_DOT3
DASH_DOT_DOT4
LONG_DASH5
LONG_DASH_DOT6

TextAlignmentType

TextAlignmentType je IntEnum za vodoravno poravnanje teksta unutar oblika.

ColladaSaveOptionsColladaSaveOptions
LEFT0
CENTER1
RIGHT2
JUSTIFY3
DISTRIBUTED4

TextAnchorType

TextAnchorType je IntEnum za okomito učvršćivanje teksta unutar oblika.

ColladaSaveOptionsColladaSaveOptions
TOP0
MIDDLE1
BOTTOM2
JUSTIFIED3

MsoFillFormat

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

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
fill_typeFillTypeAktivna vrsta ispune.
fore_colorstrPrednja (primarna) boja ispune kao RRGGBB hex.
transparencyfloatNeprozirnost ispune kao vrijednost od 0.0 (potpuno neprozirno) do 1.0 (potpuno prozirno).

ColladaSaveOptions

ChartType

fill.copy() -> MsoFillFormat

Vraća duboku kopiju ovih postavki ispune.


MsoLineFormat

Upravlja izgledom obruba/okvira oblika. Pristupa se putem shape.line.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
is_visibleboolTrue za crtanje obrisa oblika.
colorstrBoja obrisa u RRGGBB heks formatu.
weightintDebljina obrisa (debljina) u točkama.
dash_styleMsoLineDashStyleUzorak crtice za obris.
transparencyfloatNeprozirnost obrisa od 0.0 (neprozirno) do 1.0 (prozirno).

ColladaSaveOptions

ChartType

line.copy() -> MsoLineFormat

Vraća duboku kopiju ovih postavki linije.


ShapeFont

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

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrNaziv obitelji fonta (npr., "Calibri").
sizefloatVeličina fonta u točkama.
boldboolTrue za podebljani stil.
italicboolTrue za kurzivni stil.
underlineboolTrue za jednostruko podcrtavanje.
colorstrBoja fonta u RRGGBB heks formatu.

ColladaSaveOptions

ChartType

font.copy() -> ShapeFont

Vraća duboku kopiju ovih postavki fonta.


ColladaSaveOptions

Shape objekti se ne konstruiraju izravno. Koristite ws.shapes.add(...) ili ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrČitanje/PisanjeNaziv oblika (mora biti jedinstven unutar radnog lista).
drawing_typeMsoDrawingTypeColladaSaveOptionsGeometrijski tip ovog oblika.
upper_left_rowintČitanje/Pisanje0-based row index of the top-left anchor cell.
upper_left_columnintČitanje/Pisanje0-based column index of the top-left anchor cell.
lower_right_rowintČitanje/Pisanje0-based row index of the bottom-right anchor cell.
lower_right_columnintČitanje/Pisanje0-based column index of the bottom-right anchor cell.
upper_left_row_offsetintČitanje/PisanjePomak piksela od gornjeg ruba gornje lijeve ćelije.
upper_left_column_offsetintČitanje/PisanjePomak piksela od lijevog ruba gornje lijeve ćelije.
lower_right_row_offsetintČitanje/PisanjePomak piksela od gornjeg ruba donje desne ćelije.
lower_right_column_offsetintČitanje/PisanjePomak piksela od lijevog ruba donje desne ćelije.
fillMsoFillFormatColladaSaveOptionsPostavke ispune (pozadine).
lineMsoLineFormatColladaSaveOptionsPostavke obrisa/okvira.
textstrČitanje/PisanjeTekstualni sadržaj prikazan unutar oblika.
fontShapeFontColladaSaveOptionsPostavke fonta za tekst oblika.
text_horizontal_alignmentTextAlignmentTypeČitanje/PisanjeVodoravno poravnanje teksta unutar oblika.
text_vertical_alignmentTextAnchorTypeČitanje/PisanjeOkomito sidrenje teksta unutar oblika.
is_text_wrappedboolČitanje/PisanjeTrue za prelamanje teksta na granici oblika.
is_lockedboolČitanje/PisanjeTrue za zaključavanje oblika kada je zaštita radnog lista aktivna.
is_hiddenboolČitanje/PisanjeTrue za skrivanje oblika.
hyperlink`strNone`Čitanje/Pisanje

ColladaSaveOptions

ChartType

shape.copy() -> Shape

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


ShapeCollection

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

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

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čac za add(MsoDrawingType.TEXT_BOX, ...).

CSVHandler.save_csv_to_string

ColladaSaveOptionsColladaSaveOptions
countBroj oblika u zbirci (samo za čitanje).
__len__()ColladaSaveOptions count.
__iter__()Iterira kroz sve Shape objekte.
__getitem__(index)Vraća Shape na nultom indeksu index.

ColladaSaveOptions

Dodaj pravokutnik s čvrstim ispunom

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

Vidi također

 Hrvatski