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.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
UNKNOWN | 0 | TEXT_BOX | 21 |
RECTANGLE | 1 | CALLOUT | 22 |
ROUNDED_RECTANGLE | 2 | PENTAGON | 23 |
OVAL | 3 | CLOUD | 24 |
DIAMOND | 4 | HEART | 25 |
TRIANGLE | 5 | LIGHTNING_BOLT | 26 |
RIGHT_TRIANGLE | 6 | SMILEY_FACE | 27 |
PARALLELOGRAM | 7 | LEFT_RIGHT_ARROW | 28 |
TRAPEZOID | 8 | UP_DOWN_ARROW | 29 |
HEXAGON | 9 | CUBE | 30 |
OCTAGON | 10 | BEVEL | 31 |
CROSS | 11 | STAR_4 | 12 |
RIGHT_ARROW | 17 | STAR_5 | 13 |
LEFT_ARROW | 18 | STAR_6 | 14 |
UP_ARROW | 19 | STAR_7 | 15 |
DOWN_ARROW | 20 | STAR_8 | 16 |
FillType
FillType è un IntEnum che identifica il tipo di riempimento applicato a una forma.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
NONE | 0 |
SOLID | 1 |
GRADIENT | 2 |
PATTERN | 3 |
AUTOMATIC | 4 |
MsoLineDashStyle
MsoLineDashStyle è un IntEnum per il modello di tratteggio della linea di bordo/contorno.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
SOLID | 0 |
DASH | 1 |
DOT | 2 |
DASH_DOT | 3 |
DASH_DOT_DOT | 4 |
LONG_DASH | 5 |
LONG_DASH_DOT | 6 |
TextAlignmentType
TextAlignmentType è un IntEnum per l’allineamento orizzontale del testo all’interno di una forma.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
LEFT | 0 |
CENTER | 1 |
RIGHT | 2 |
JUSTIFY | 3 |
DISTRIBUTED | 4 |
TextAnchorType
TextAnchorType è un IntEnum per l’ancoraggio verticale del testo all’interno di una forma.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
TOP | 0 |
MIDDLE | 1 |
BOTTOM | 2 |
JUSTIFIED | 3 |
MsoFillFormat
Controlla l’aspetto del riempimento di una forma. Accessibile tramite shape.fill.
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
fill_type | FillType | Il tipo di riempimento attivo. |
fore_color | str | Colore di riempimento in primo piano (primario) in formato esadecimale RRGGBB. |
transparency | float | Opacità del riempimento come valore da 0.0 (completamente opaco) a 1.0 (completamente trasparente). |
ColladaSaveOptions
copia
fill.copy() -> MsoFillFormatRestituisce una copia profonda di queste impostazioni di riempimento.
MsoLineFormat
Controlla l’aspetto del contorno/bordo di una forma. Accessibile tramite shape.line.
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
is_visible | bool | True per disegnare il contorno della forma. |
color | str | Colore del contorno in esadecimale RRGGBB. |
weight | int | Peso del contorno (spessore) in punti. |
dash_style | MsoLineDashStyle | Modello di tratteggio per il contorno. |
transparency | float | Opacità del contorno da 0.0 (opaco) a 1.0 (trasparente). |
ColladaSaveOptions
copia
line.copy() -> MsoLineFormatRestituisce una copia profonda di queste impostazioni di linea.
ShapeFont
Controlla il carattere del testo all’interno di una forma. Accessibile tramite shape.font.
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
name | str | Nome della famiglia di caratteri (ad es., "Calibri"). |
size | float | Dimensione del carattere in punti. |
bold | bool | True per peso grassetto. |
italic | bool | True per stile corsivo. |
underline | bool | True per sottolineatura singola. |
color | str | Colore del carattere in esadecimale RRGGBB. |
ColladaSaveOptions
copia
font.copy() -> ShapeFontRestituisce 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
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
name | str | Lettura/Scrittura | Nome della forma (deve essere univoco all’interno del foglio di lavoro). |
drawing_type | MsoDrawingType | ColladaSaveOptions | Il tipo geometrico di questa forma. |
upper_left_row | int | Lettura/Scrittura | 0-based row index of the top-left anchor cell. |
upper_left_column | int | Read/Write | 0-based column index of the top-left anchor cell. |
lower_right_row | int | Read/Write | 0-based row index of the bottom-right anchor cell. |
lower_right_column | int | Read/Write | 0-based column index of the bottom-right anchor cell. |
upper_left_row_offset | int | Read/Write | Offset in pixel dal bordo superiore della cella in alto a sinistra. |
upper_left_column_offset | int | Read/Write | Offset in pixel dal bordo sinistro della cella in alto a sinistra. |
lower_right_row_offset | int | Read/Write | Offset in pixel dal bordo superiore della cella in basso a destra. |
lower_right_column_offset | int | Read/Write | Offset in pixel dal bordo sinistro della cella in basso a destra. |
fill | MsoFillFormat | ColladaSaveOptions | Impostazioni di riempimento (sfondo). |
line | MsoLineFormat | ColladaSaveOptions | Impostazioni di contorno/bordo. |
text | str | Read/Write | Contenuto testuale visualizzato all’interno della forma. |
font | ShapeFont | ColladaSaveOptions | Impostazioni del carattere per il testo della forma. |
text_horizontal_alignment | TextAlignmentType | Lettura/Scrittura | Allineamento orizzontale del testo all’interno della forma. |
text_vertical_alignment | TextAnchorType | Lettura/Scrittura | Ancoraggio verticale del testo all’interno della forma. |
is_text_wrapped | bool | Lettura/Scrittura | True per andare a capo del testo al bordo della forma. |
is_locked | bool | Lettura/Scrittura | True per bloccare la forma quando la protezione del foglio di lavoro è attiva. |
is_hidden | bool | Lettura/Scrittura | True per nascondere la forma. |
hyperlink | `str | None` | Lettura/Scrittura |
ColladaSaveOptions
copia
shape.copy() -> ShapeRestituisce 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
) -> ShapeAggiunge 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
) -> ShapeScorciatoia per add(MsoDrawingType.TEXT_BOX, ...).
Aggiunge un grafico del tipo specificato. Tutti gli argomenti di posizione sono indici di riga/colonna a base zero.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | Numero 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
- Cells Python Riferimento API home
- Aggiunge una serie di dati.
areaè una stringa di intervallo come"Sheet1!B1:B5". Impostais_vertical=Truequando i dati sono disposti in colonne.chart_typesovrascrive il tipo di grafico padre per questa serie (usato nei grafici combinati). - Riferimento alla classe Worksheet.
- Riferimento al grafico.
- Guida introduttiva