Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss supporta l’aggiunta di forme geometriche e caselle di testo ai fogli di lavoro tramite il ShapeCollection (ws.shapes). Ogni forma è rappresentata da un Shape oggetto con proprietà configurabili di riempimento, linea e testo.

ColladaSaveOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType è un IntEnum che identifica il tipo di forma geometrica.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
UNKNOWN0TEXT_BOX21
RECTANGLE1CALLOUT22
ROUNDED_RECTANGLE2PENTAGON23
OVAL3CLOUD24
DIAMOND4HEART25
TRIANGLE5LIGHTNING_BOLT26
RIGHT_TRIANGLE6SMILEY_FACE27
PARALLELOGRAM7LEFT_RIGHT_ARROW28
TRAPEZOID8UP_DOWN_ARROW29
HEXAGON9CUBE30
OCTAGON10BEVEL31
CROSS11STAR_412
RIGHT_ARROW17STAR_513
LEFT_ARROW18STAR_614
UP_ARROW19STAR_715
DOWN_ARROW20STAR_816

FillType

FillType è un IntEnum che identifica il tipo di riempimento applicato a una forma.

ColladaSaveOptionsColladaSaveOptions
NONE0
SOLID1
GRADIENT2
PATTERN3
AUTOMATIC4

MsoLineDashStyle

MsoLineDashStyle è un IntEnum per il modello di tratteggio della linea di bordo/contorno.

ColladaSaveOptionsColladaSaveOptions
SOLID0
DASH1
DOT2
DASH_DOT3
DASH_DOT_DOT4
LONG_DASH5
LONG_DASH_DOT6

TextAlignmentType

TextAlignmentType è un IntEnum per l’allineamento orizzontale del testo all’interno di una forma.

ColladaSaveOptionsColladaSaveOptions
LEFT0
CENTER1
RIGHT2
JUSTIFY3
DISTRIBUTED4

TextAnchorType

TextAnchorType è un IntEnum per l’ancoraggio verticale del testo all’interno di una forma.

ColladaSaveOptionsColladaSaveOptions
TOP0
MIDDLE1
BOTTOM2
JUSTIFIED3

MsoFillFormat

Controlla l’aspetto del riempimento di una forma. Accessibile tramite shape.fill.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
fill_typeFillTypeIl tipo di riempimento attivo.
fore_colorstrColore di riempimento in primo piano (primario) in formato esadecimale RRGGBB.
transparencyfloatOpacità del riempimento come valore da 0.0 (completamente opaco) a 1.0 (completamente trasparente).

ColladaSaveOptions

copia

fill.copy() -> MsoFillFormat

Restituisce una copia profonda di queste impostazioni di riempimento.


MsoLineFormat

Controlla l’aspetto del contorno/bordo di una forma. Accessibile tramite shape.line.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
is_visibleboolTrue per disegnare il contorno della forma.
colorstrColore del contorno in esadecimale RRGGBB.
weightintPeso del contorno (spessore) in punti.
dash_styleMsoLineDashStyleModello di tratteggio per il contorno.
transparencyfloatOpacità del contorno da 0.0 (opaco) a 1.0 (trasparente).

ColladaSaveOptions

copia

line.copy() -> MsoLineFormat

Restituisce una copia profonda di queste impostazioni di linea.


ShapeFont

Controlla il carattere del testo all’interno di una forma. Accessibile tramite shape.font.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrNome della famiglia di caratteri (ad es., "Calibri").
sizefloatDimensione del carattere in punti.
boldboolTrue per peso grassetto.
italicboolTrue per stile corsivo.
underlineboolTrue per sottolineatura singola.
colorstrColore del carattere in esadecimale RRGGBB.

ColladaSaveOptions

copia

font.copy() -> ShapeFont

Restituisce una copia profonda di queste impostazioni del font.


ColladaSaveOptions

Shape gli oggetti non sono costruiti direttamente. Usa ws.shapes.add(...) o ws.shapes.add_text_box(...).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
namestrLettura/ScritturaNome della forma (deve essere univoco all’interno del foglio di lavoro).
drawing_typeMsoDrawingTypeColladaSaveOptionsIl tipo geometrico di questa forma.
upper_left_rowintLettura/Scrittura0-based row index of the top-left anchor cell.
upper_left_columnintRead/Write0-based column index of the top-left anchor cell.
lower_right_rowintRead/Write0-based row index of the bottom-right anchor cell.
lower_right_columnintRead/Write0-based column index of the bottom-right anchor cell.
upper_left_row_offsetintRead/WriteOffset in pixel dal bordo superiore della cella in alto a sinistra.
upper_left_column_offsetintRead/WriteOffset in pixel dal bordo sinistro della cella in alto a sinistra.
lower_right_row_offsetintRead/WriteOffset in pixel dal bordo superiore della cella in basso a destra.
lower_right_column_offsetintRead/WriteOffset in pixel dal bordo sinistro della cella in basso a destra.
fillMsoFillFormatColladaSaveOptionsImpostazioni di riempimento (sfondo).
lineMsoLineFormatColladaSaveOptionsImpostazioni di contorno/bordo.
textstrRead/WriteContenuto testuale visualizzato all’interno della forma.
fontShapeFontColladaSaveOptionsImpostazioni del carattere per il testo della forma.
text_horizontal_alignmentTextAlignmentTypeLettura/ScritturaAllineamento orizzontale del testo all’interno della forma.
text_vertical_alignmentTextAnchorTypeLettura/ScritturaAncoraggio verticale del testo all’interno della forma.
is_text_wrappedboolLettura/ScritturaTrue per andare a capo del testo al bordo della forma.
is_lockedboolLettura/ScritturaTrue per bloccare la forma quando la protezione del foglio di lavoro è attiva.
is_hiddenboolLettura/ScritturaTrue per nascondere la forma.
hyperlink`strNone`Lettura/Scrittura

ColladaSaveOptions

copia

shape.copy() -> Shape

Restituisce una copia profonda di questa forma con tutta la formattazione preservata.


ShapeCollection

ShapeCollection è accessibile come ws.shapes. Contiene tutte le forme su un foglio di lavoro.

ColladaSaveOptions

Package: aspose.cells_foss

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

Aggiunge una forma del tipo specificato. Tutti gli argomenti di posizione sono indici di riga/colonna a base zero.

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

Scorciatoia per add(MsoDrawingType.TEXT_BOX, ...).

Aggiunge un grafico del tipo specificato. Tutti gli argomenti di posizione sono indici di riga/colonna a base zero.

ColladaSaveOptionsColladaSaveOptions
countNumero di forme nella collezione (sola lettura).
__len__()ColladaSaveOptions count.
__iter__()Itera su tutti i Shape oggetti.
__getitem__(index)Restituisce il Shape con indice a base zero index.

ColladaSaveOptions

Aggiungi un rettangolo con riempimento solido.

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

Aggiungi una casella di testo.

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

Vedi anche

 Italiano