Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss támogatja geometriai alakzatok és szövegdobozok hozzáadását a munkalapokhoz a ShapeCollection (ws.shapes). Minden alakzat egy Shape objektummal, amelynek konfigurálható kitöltési, vonal- és szövegtulajdonságai vannak.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType egy IntEnum amely azonosítja a geometriai alakzat típusát.

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 egy IntEnum amely azonosítja az alakzatra alkalmazott kitöltés típusát.

ColladaSaveOptionsColladaSaveOptions
NONE0
SOLID1
GRADIENT2
PATTERN3
AUTOMATIC4

MsoLineDashStyle

MsoLineDashStyle egy IntEnum a szegély/körvonal vonal szaggatottsági mintázatához.

ColladaSaveOptionsColladaSaveOptions
SOLID0
DASH1
DOT2
DASH_DOT3
DASH_DOT_DOT4
LONG_DASH5
LONG_DASH_DOT6

TextAlignmentType

TextAlignmentType egy IntEnum a alakzaton belüli vízszintes szövegigazításra.

ColladaSaveOptionsColladaSaveOptions
LEFT0
CENTER1
RIGHT2
JUSTIFY3
DISTRIBUTED4

TextAnchorType

TextAnchorType egy IntEnum a alakzaton belüli függőleges szöveg rögzítésére.

ColladaSaveOptionsColladaSaveOptions
TOP0
MIDDLE1
BOTTOM2
JUSTIFIED3

MsoFillFormat

A forma kitöltésének megjelenését szabályozza. Elérhető a shape.fill.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
fill_typeFillTypeAz aktív kitöltés típusa.
fore_colorstrElőtér (elsődleges) kitöltőszín RRGGBB hexadecimális formátumban.
transparencyfloatKitöltés átlátszatlansága értékként a 0.0 (teljesen átlátszatlan) -tól 1.0 (teljesen átlátszó).

ColladaSaveOptions

másolat

fill.copy() -> MsoFillFormat

Visszaad egy mélymásolatot ezekről a kitöltési beállításokról.


MsoLineFormat

A forma körvonalának/szegélyének megjelenését szabályozza. Elérhető a shape.line.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
is_visibleboolTrue a forma körvonalának megrajzolásához.
colorstrKörvonal színe RRGGBB hexadecimális formátumban.
weightintKörvonal vastagsága (szélessége) pontban.
dash_styleMsoLineDashStyleVonalvonalas minta a körvonalhoz.
transparencyfloatKörvonal átlátszatlansága ettől 0.0 (átlátszatlan) eddig 1.0 (átlátszó).

ColladaSaveOptions

másolat

line.copy() -> MsoLineFormat

Visszaad egy mélymásolatot ezekről a vonalbeállításokról.


ShapeFont

A szöveg betűtípusát szabályozza egy alakzatban. Elérhető a shape.font.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrBetűcsalád neve (például,., "Calibri").
sizefloatBetűméret pontban.
boldboolTrue a félkövér súlyhoz.
italicboolTrue az dőlt stílushoz.
underlineboolTrue az egyszeres aláhúzáshoz.
colorstrBetűszín RRGGBB hexadecimális formátumban.

ColladaSaveOptions

másolat

font.copy() -> ShapeFont

Visszaad egy mélymásolatot ezekről a betűtípus-beállításokról.


ColladaSaveOptions

Shape az objektumok nem építhetők közvetlenül. Használja a ws.shapes.add(...) vagy ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrOlvasás/írásAlakzat neve (a munkalapon belül egyedinek kell lennie).
drawing_typeMsoDrawingTypeColladaSaveOptionsAz alakzat geometriai típusa.
upper_left_rowintOlvasás/írás0-based row index of the top-left anchor cell.
upper_left_columnintOlvasás/írás0-based column index of the top-left anchor cell.
lower_right_rowintOlvasás/írás0-based row index of the bottom-right anchor cell.
lower_right_columnintOlvasás/írás0-based column index of the bottom-right anchor cell.
upper_left_row_offsetintOlvasás/írásPixel eltolás a bal felső cella felső szélétől.
upper_left_column_offsetintOlvasás/írásPixel eltolás a bal felső cella bal szélétől.
lower_right_row_offsetintOlvasás/írásPixel eltolás a jobb alsó cella felső szélétől.
lower_right_column_offsetintOlvasás/írásPixel eltolás a jobb alsó cella bal szélétől.
fillMsoFillFormatColladaSaveOptionsKitöltés (háttér) beállításai.
lineMsoLineFormatColladaSaveOptionsKörvonal/szegély beállításai.
textstrOlvasás/írásA forma belsejében megjelenő szövegtartalom.
fontShapeFontColladaSaveOptionsBetűtípus beállítások a forma szövegéhez.
text_horizontal_alignmentTextAlignmentTypeOlvasás/írásVízszintes szövegigazítás az alakzaton belül.
text_vertical_alignmentTextAnchorTypeOlvasás/írásFüggőleges szöveg rögzítése az alakzaton belül.
is_text_wrappedboolOlvasás/írásTrue a szöveg tördelése a forma határán.
is_lockedboolOlvasás/írásTrue a forma zárolása, amikor a munkalap védelem aktív.
is_hiddenboolOlvasás/írásTrue a forma elrejtése.
hyperlink`strNone`Olvasás/írás

ColladaSaveOptions

másolat

shape.copy() -> Shape

Visszaad egy mélymásolatot erről az alakzatról, az összes formázás megőrzésével.


ShapeCollection

ShapeCollection a következőképpen érhető el ws.shapes. Tartalmazza a munkalap összes alakzatát.

ColladaSaveOptions

Properties

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

Hozzáad egy megadott típusú alakzatot. Minden pozícióargumentum 0‑alapú sor/oszlop index.

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

Rövidítés a add(MsoDrawingType.TEXT_BOX, ...).

add_pie

ColladaSaveOptionsColladaSaveOptions
countA gyűjteményben lévő alakzatok száma (csak olvasható).
__len__()ColladaSaveOptions count.
__iter__()Végigiterál az összes Shape objektumon.
__getitem__(index)Visszaadja a Shape nulla-alapú index.

ColladaSaveOptions

Adj hozzá egy téglalapot szilárd kitöltéssel

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

Adj hozzá egy szövegdobozt

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

Lásd még

 Magyar