Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss suporta a adição de formas geométricas e caixas de texto às planilhas através do ShapeCollection (ws.shapes). Cada forma é representada por um Shape objeto com propriedades configuráveis de preenchimento, linha e texto.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType é um IntEnum identificando o tipo de forma geométrica.

FillType

FillType é um IntEnum identificando o tipo de preenchimento aplicado a uma forma.

MsoLineDashStyle

MsoLineDashStyle é um IntEnum para o padrão de traços da linha de borda/contorno.

TextAlignmentType

TextAlignmentType é um IntEnum para o alinhamento horizontal de texto dentro de uma forma.

TextAnchorType

TextAnchorType é um IntEnum para o ancoramento vertical de texto dentro de uma forma.

MsoFillFormat

Controla a aparência de preenchimento de uma forma. Acessado via shape.fill.

ImageRenderOptions

ImageRenderOptions

cópia

fill.copy() -> MsoFillFormat

Retorna uma cópia profunda dessas configurações de preenchimento.

MsoLineFormat

Controla a aparência do contorno/borda de uma forma. Acessado via shape.line.

ImageRenderOptions

ImageRenderOptions

cópia

line.copy() -> MsoLineFormat

Retorna uma cópia profunda dessas configurações de linha.

ShapeFont

Controla a fonte do texto dentro de uma forma. Acessado via shape.font.

ImageRenderOptions

ImageRenderOptions

cópia

font.copy() -> ShapeFont

Retorna uma cópia profunda dessas configurações de fonte.

ImageRenderOptions

Shape os objetos não são construídos diretamente. Use ws.shapes.add(...) ou ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

cópia

shape.copy() -> Shape

Retorna uma cópia profunda desta forma com toda a formatação preservada.

ShapeCollection

ShapeCollection é acessado como ws.shapes. Ele contém todas as formas em uma planilha.

ImageRenderOptions

adicionar

ws.shapes.add(
    drawing_type: MsoDrawingType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

Adiciona uma forma do tipo especificado. Todos os argumentos de posição são índices de linha/coluna baseados em 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

Atalho para add(MsoDrawingType.TEXT_BOX, ...).

Propriedades e Iteração

ImageRenderOptions

Adicionar um Retângulo com Preenchimento Sólido

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

Adicionar uma Caixa de Texto

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

Veja Também

• Cells Python Referência da API início
• Referência da classe Workbook
• Referência da classe Worksheet
• Referência de Gráfico
• Introdução