Aspose.Cells FOSS
Python
Shape

Shape

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 המזהה את סוג הצורה הגאומטרית.

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

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 הוא IntEnum לצורת קו המתאר/גבול המפוספס.

TextAlignmentType

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

TextAnchorType

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

MsoFillFormat

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

ColladaSaveOptions

ColladaSaveOptions

copy 

fill.copy() -> MsoFillFormat

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

MsoLineFormat

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

ColladaSaveOptions

ColladaSaveOptions

copy 

line.copy() -> MsoLineFormat

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

ShapeFont

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

ColladaSaveOptions

ColladaSaveOptions

copy 

font.copy() -> ShapeFont

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

ColladaSaveOptions

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

ColladaSaveOptions

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, ...).

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

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

ראה גם

 עברית