Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss admite la incorporación de formas geométricas y cuadros de texto a las hojas de cálculo a través de ShapeCollection (ws.shapes). Cada forma está representada por un Shape objeto con propiedades configurables de relleno, línea y texto.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType es un IntEnum que identifica el tipo de forma geométrica.

FillType

FillType es un IntEnum que identifica el tipo de relleno aplicado a una forma.

MsoLineDashStyle

MsoLineDashStyle es un IntEnum para el patrón de guiones de la línea del borde/contorno.

TextAlignmentType

TextAlignmentType es un IntEnum para la alineación horizontal del texto dentro de una forma.

TextAnchorType

TextAnchorType es un IntEnum para anclaje vertical de texto dentro de una forma.

MsoFillFormat

Controla la apariencia de relleno de una forma. Accedido a través de shape.fill.

ColladaSaveOptions

ColladaSaveOptions

copy

fill.copy() -> MsoFillFormat

Devuelve una copia profunda de estos ajustes de relleno.

MsoLineFormat

Controla la apariencia del contorno/borde de una forma. Accedido a través de shape.line.

ColladaSaveOptions

ColladaSaveOptions

copy

line.copy() -> MsoLineFormat

Devuelve una copia profunda de estos ajustes de línea.

ShapeFont

Controla la fuente del texto dentro de una forma. Se accede a través de shape.font.

ColladaSaveOptions

ColladaSaveOptions

copy

font.copy() -> ShapeFont

Devuelve una copia profunda de estos ajustes de fuente.

ColladaSaveOptions

Shape Los objetos no se construyen directamente. Use ws.shapes.add(...) o ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptions

copy

shape.copy() -> Shape

Devuelve una copia profunda de esta forma con todo el formato preservado.

ShapeCollection

ShapeCollection se accede como ws.shapes. Contiene todas las formas en una hoja de cálculo.

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

Agrega una forma del tipo especificado. Todos los argumentos de posición son índices de fila/columna basados en 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

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

Propiedades e iteración

ColladaSaveOptions

Agregar un rectángulo con relleno 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")

Agregar un cuadro 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")

Ver también

• Cells Python Referencia de API inicio
• Referencia de la clase Workbook
• Referencia de la clase Worksheet
• Referencia de gráfico
• Primeros pasos