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 شناسایی نوع شکل هندسی.

FillType

FillType یک IntEnum شناسایی نوع پرکاری اعمال شده به یک شکل.

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

همچنین ببینید

• خانه مرجع API Cells Python
• مرجع کلاس Workbook
• مرجع کلاس Worksheet
• مرجع نمودار
• شروع کار