Shape

Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss תומך בהוספת צורות גאומטריות ותיבות טקסט לגיליונות דרך ShapeCollection (ws.shapes). כל צורה מיוצגת על ידי Shape אובייקט עם תכונות מילוי, קו וטקסט שניתן להגדיר.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType הוא IntEnum המזהה את סוג הצורה הגאומטרית.

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 הוא IntEnum המזהה את סוג המילוי המיושם על צורה.

ColladaSaveOptionsColladaSaveOptions
NONE0
SOLID1
GRADIENT2
PATTERN3
AUTOMATIC4

MsoLineDashStyle

MsoLineDashStyle הוא IntEnum לצורת קו המתאר/גבול המפוספס.

ColladaSaveOptionsColladaSaveOptions
SOLID0
DASH1
DOT2
DASH_DOT3
DASH_DOT_DOT4
LONG_DASH5
LONG_DASH_DOT6

TextAlignmentType

TextAlignmentType הוא IntEnum ליישור טקסט אופקי בתוך צורה.

ColladaSaveOptionsColladaSaveOptions
LEFT0
CENTER1
RIGHT2
JUSTIFY3
DISTRIBUTED4

TextAnchorType

TextAnchorType הוא IntEnum לעיגון טקסט אנכי בתוך צורה.

ColladaSaveOptionsColladaSaveOptions
TOP0
MIDDLE1
BOTTOM2
JUSTIFIED3

MsoFillFormat

שולט במראה המילוי של צורה. נגיש דרך shape.fill.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
fill_typeFillTypeסוג המילוי הפעיל.
fore_colorstrצבע מילוי הרקע (הראשי) בפורמט הקסדצימלי RRGGBB.
transparencyfloatשקיפות המילוי כערך מ 0.0 (לא שקוף כלל) עד 1.0 (שקוף לחלוטין).

ColladaSaveOptions

copy

fill.copy() -> MsoFillFormat

מחזיר עותק עמוק של הגדרות המילוי האלו.


MsoLineFormat

שולט במראה הקו החיצוני/הגבול של צורה. נגיש דרך shape.line.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
is_visibleboolTrue לצייר את קו המתאר של הצורה.
colorstrצבע קו המתאר בפורמט הקסדצימלי RRGGBB.
weightintעובי קו המתאר (עובי) בנקודות.
dash_styleMsoLineDashStyleתבנית מקווקו לקו המתאר.
transparencyfloatשקיפות קו המתאר מ- 0.0 (אטום) עד 1.0 (שקוף).

ColladaSaveOptions

copy

line.copy() -> MsoLineFormat

מחזיר עותק עמוק של הגדרות הקו האלו.


ShapeFont

שולט על גופן הטקסט בתוך צורה. נגיש דרך shape.font.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrשם משפחת הגופנים (למשל,., "Calibri").
sizefloatגודל הגופן בנקודות.
boldboolTrue למשקל מודגש.
italicboolTrue לסגנון נטוי.
underlineboolTrue לקו תחתי יחיד.
colorstrצבע הגופן בפורמט הקסדצימלי RRGGBB.

ColladaSaveOptions

copy

font.copy() -> ShapeFont

מחזיר עותק עמוק של הגדרות הגופן האלו.


ColladaSaveOptions

Shape אובייקטים אינם נבנים ישירות. השתמש ב- ws.shapes.add(...) או ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrקריאה/כתיבהשם הצורה (חייב להיות ייחודי בתוך הגיליון).
drawing_typeMsoDrawingTypeColladaSaveOptionsהסוג הגאומטרי של הצורה הזו.
upper_left_rowintקריאה/כתיבה0-based row index of the top-left anchor cell.
upper_left_columnintקריאה/כתיבה0-based column index of the top-left anchor cell.
lower_right_rowintקריאה/כתיבה0-based row index of the bottom-right anchor cell.
lower_right_columnintקריאה/כתיבה0-based column index of the bottom-right anchor cell.
upper_left_row_offsetintקריאה/כתיבההזחה בפיקסלים מהקצה העליון של התא העליון‑שמאלי.
upper_left_column_offsetintקריאה/כתיבההזחה בפיקסלים מהקצה השמאלי של התא העליון‑שמאלי.
lower_right_row_offsetintקריאה/כתיבההזחה בפיקסלים מהקצה העליון של התא התחתון‑ימני.
lower_right_column_offsetintקריאה/כתיבההזחה בפיקסלים מהקצה השמאלי של התא התחתון‑ימני.
fillMsoFillFormatColladaSaveOptionsהגדרות מילוי (רקע).
lineMsoLineFormatColladaSaveOptionsהגדרות קו מתאר/גבול.
textstrקריאה/כתיבהתוכן הטקסט המוצג בתוך הצורה.
fontShapeFontColladaSaveOptionsהגדרות גופן לטקסט הצורה.
text_horizontal_alignmentTextAlignmentTypeקריאה/כתיבהיישור טקסט אופקי בתוך הצורה.
text_vertical_alignmentTextAnchorTypeקריאה/כתיבהעיגון טקסט אנכי בתוך הצורה.
is_text_wrappedboolקריאה/כתיבהTrue לעטוף טקסט בגבול הצורה.
is_lockedboolקריאה/כתיבהTrue לנעול את הצורה כאשר הגנת הגיליון פעילה.
is_hiddenboolקריאה/כתיבהTrue להסתיר את הצורה.
hyperlink`strNone`קריאה/כתיבה

ColladaSaveOptions

copy

shape.copy() -> Shape

מחזיר עותק עמוק של הצורה הזו עם כל העיצוב שמור.


ShapeCollection

ShapeCollection נגיש כ ws.shapes. הוא מכיל את כל הצורות בגיליון.

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

מוסיף צורה מהסוג שצוין. כל ארגומנטים של המיקום הם אינדקסים של שורה/עמודה שמתחילים מ‑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

קיצור ל add(MsoDrawingType.TEXT_BOX, ...).

מאפיינים וחזרה

ColladaSaveOptionsColladaSaveOptions
countמספר הצורות באוסף (קריאה בלבד).
__len__()ColladaSaveOptions count.
__iter__()עובר על כל Shape אובייקטים.
__getitem__(index)מחזיר את Shape ב‑אינדקס שמתחיל מאפס index.

ColladaSaveOptions

הוסף מלבן עם מילוי אחיד

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

הוסף תיבת טקסט

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

ראה גם

 עברית