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 شناسایی نوع شکل هندسی.
| Name | Type | Access | Description |
|---|---|---|---|
upper_left_row | `` | Read/Write | Gets or sets the upper left row. |
upper_left_column | `` | Read/Write | Gets or sets the upper left column. |
lower_right_row | `` | Read/Write | Gets or sets the lower right row. |
lower_right_column | `` | Read/Write | Gets or sets the lower right column. |
upper_left_row_offset | `` | Read/Write | Gets or sets the upper left row offset. |
upper_left_column_offset | `` | Read/Write | Gets or sets the upper left column offset. |
lower_right_row_offset | `` | Read/Write | Gets or sets the lower right row offset. |
lower_right_column_offset | `` | Read/Write | Gets or sets the lower right column offset. |
name | `` | Read | Gets the name. |
drawing_type | `` | Read | Gets the drawing type. |
fill | `` | Read | Gets the fill. |
line | `` | Read | Gets the line. |
text | `` | Read | Gets the text. |
font | `` | Read | Gets the font. |
text_horizontal_alignment | `` | Read | Gets the text horizontal alignment. |
text_vertical_alignment | `` | Read | Gets the text vertical alignment. |
is_text_wrapped | `` | Read | Gets the is text wrapped. |
is_locked | `` | Read | Gets the is locked. |
is_hidden | `` | Read | Gets the is hidden. |
placement | `` | Read | Gets the placement. |
hyperlink | `` | Read | Gets the hyperlink. |
FillType
FillType یک IntEnum شناسایی نوع پرکاری اعمال شده به یک شکل.
| Signature | Description |
|---|---|
__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
کپی
fill.copy() -> MsoFillFormatیک کپی عمیق از این تنظیمات پر شدن را برمیگرداند.
MsoLineFormat
ظاهر حاشیه/خط دور یک شکل را کنترل میکند. دسترسی از طریق shape.line.
ColladaSaveOptions
ColladaSaveOptions
کپی
line.copy() -> MsoLineFormatیک کپی عمیق از این تنظیمات خط را برمیگرداند.
ShapeFont
کنترل قلم متن داخل یک شکل. دسترسی از طریق shape.font.
ColladaSaveOptions
ColladaSaveOptions
کپی
font.copy() -> ShapeFontیک کپی عمیق از این تنظیمات قلم را برمیگرداند.
ColladaSaveOptions
Shape اشیاء بهصورت مستقیم ساخته نمیشوند. استفاده کنید ws.shapes.add(...) یا ws.shapes.add_text_box(...).
ColladaSaveOptions
ColladaSaveOptions
کپی
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یک شکل از نوع مشخص شده را اضافه میکند. تمام آرگومانهای موقعیت به صورت ایندکسهای ردیف/ستون صفر‑پایه هستند.
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
یک مستطیل با پر کردن Solid Fill اضافه کنید
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")