Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss підтримує додавання геометричних фігур та текстових полів до робочих листів через the ShapeCollection (ws.shapes). Кожна фігура представлена Shape об’єктом з налаштовуваними властивостями заливки, лінії та тексту.

Enumerations: 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.

Enumerations

Enumerations

копіювати

fill.copy() -> MsoFillFormat

Повертає глибоку копію цих налаштувань заповнення.

MsoLineFormat

Керує зовнішнім виглядом контуру/рамки форми. Доступно через shape.line.

Enumerations

Enumerations

копіювати

line.copy() -> MsoLineFormat

Повертає глибоку копію цих налаштувань лінії.

ShapeFont

Керує шрифтом тексту всередині форми. Доступно через shape.font.

Enumerations

Enumerations

копіювати

font.copy() -> ShapeFont

Повертає глибоку копію цих налаштувань шрифту.

Enumerations

Shape об’єкти не створюються безпосередньо. Використовуйте ws.shapes.add(...) або ws.shapes.add_text_box(...).

Enumerations

Enumerations

копіювати

shape.copy() -> Shape

Повертає глибоку копію цієї фігури зі збереженням усіх форматувань.

ShapeCollection

ShapeCollection доступний як ws.shapes. Він містить усі форми на аркуші.

Enumerations

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

Властивості та ітерація

Enumerations

Додати прямокутник зі суцільним заповненням

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

Див. також

• Cells Python API Reference home
• Посилання на клас Workbook
• Довідка класу Worksheet
• Посилання на діаграму
• Початок роботи