Working with Shapes

Lavorare con le forme

Aspose.Cells FOSS per Java ti consente di aggiungere e gestire oggetti di disegno (forme automatiche) ancorati alle celle del foglio di lavoro. Le forme sono esposte tramite ShapeCollection accessibile tramite Worksheet.getShapes(). Ogni forma ha un tipo di geometria, un tipo di forma automatica, un nome e una posizione di ancoraggio a due celle.

Panoramica

Le forme in un foglio di lavoro sono gestite tramite ShapeCollection. Aggiungi una nuova forma con ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width), che restituisce l’indice basato su zero della nuova forma. Fornisci un valore AutoShapeType per specificare la geometria predefinita.

Una volta che una forma è nella raccolta, puoi leggere e scrivere il suo nome, il tipo di geometria, il tipo di forma automatica e le posizioni delle celle di ancoraggio.

Classi chiave

Classe	Descrizione
`Shape`	Rappresenta un oggetto di disegno (forma automatica) con nome, geometria e posizione di ancoraggio della cella.
`ShapeCollection`	Raccolta di tutte le forme di disegno su un foglio di lavoro. Supporta il conteggio, l’accesso per indice, l’aggiunta e la rimozione.
`AutoShapeType`	Enum che specifica la geometria predefinita DrawingML per una forma.
`ShapeModel`	Modello interno di serializzazione per una forma. Espone i campi grezzi XML per un uso avanzato di round-trip.

Aggiungere una forma

Usa ShapeCollection.add(...) per inserire un oggetto di disegno. Il metodo accetta:

Un valore AutoShapeType per il preset di geometria.
L’ancora in alto a sinistra (riga, offset riga, colonna, offset colonna) — tutti interi a base zero.
L’altezza e la larghezza della forma in pixel.

Il metodo restituisce l’indice a base zero della nuova forma.

Lettura delle proprietà della forma

Dato un oggetto Shape, sono disponibili i seguenti metodi di lettura:

Shape.getName() — la stringa del nome interno della forma.
Shape.getGeometryType() — la stringa del tipo di geometria.
Shape.getAutoShapeType() — il valore enum AutoShapeType.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — la cella di riferimento in alto a sinistra.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — la cella di riferimento in basso a destra.

Scrittura delle proprietà della forma

Shape.setName(name) — rinomina la forma.
Shape.setGeometryType(type) — cambia la stringa del tipo di geometria.
Shape.setAutoShapeType(type) — cambia il preset AutoShapeType.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — riposiziona.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — ridimensiona l’ancora.

API Reference Riepilogo

Shape

Metodo	Tipo di ritorno	Descrizione
`getName()`	`String`	Nome interno della forma.
`setName(name)`	`void`	Imposta il nome interno.
`getGeometryType()`	`String`	Stringa identificatore del tipo di geometria.
`setGeometryType(type)`	`void`	Imposta la stringa del tipo di geometria.
`getAutoShapeType()`	`AutoShapeType`	Valore enum della geometria predefinita della forma automatica.
`setAutoShapeType(type)`	`void`	Imposta la geometria predefinita della forma automatica.
`getUpperLeftRow()`	`int`	Indice di riga della cella di ancoraggio superiore sinistra.
`setUpperLeftRow(row)`	`void`	Imposta la riga di ancoraggio in alto a sinistra.
`getUpperLeftColumn()`	`int`	Indice di colonna della cella di ancoraggio superiore sinistra.
`setUpperLeftColumn(col)`	`void`	Imposta la colonna di ancoraggio superiore sinistra.
`getLowerRightRow()`	`int`	Indice di riga della cella di ancoraggio situata in basso a destra.
`setLowerRightRow(row)`	`void`	Imposta la riga di ancoraggio nell’angolo inferiore destro.
`getLowerRightColumn()`	`int`	Indice della colonna della cella di ancoraggio situata in basso a destra.
`setLowerRightColumn(col)`	`void`	Imposta la colonna di ancoraggio situata in basso a destra.

ShapeCollection

Metodo	Tipo di ritorno	Descrizione
`getCount()`	`int`	Numero di forme nel foglio di lavoro.
`get(index)`	`Shape`	Restituisce la forma all’indice a base zero specificato.
`add(...)`	`int`	Aggiunge una nuova forma; restituisce il suo indice nella collezione.
`removeAt(index)`	`void`	Rimuove la forma all’indice specificato.

Vedi anche

Aspose.Cells for Java — Enterprise Documentation