Working with Charts

Lavorare con i grafici

Aspose.Cells FOSS per Java conserva i grafici incorporati durante il caricamento e il salvataggio delle cartelle di lavoro XLSX. È possibile ispezionare i grafici esistenti, interrogare il loro tipo e la loro posizione, e aggiungere nuovi grafici di tipo standard programmaticamente. I tipi ChartEx come Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel e Map sono conservati durante il round-trip ma non possono essere creati tramite il API.

Panoramica

I grafici in un foglio di lavoro sono gestiti tramite il ChartCollection accessibile tramite Worksheet.getCharts(). Ogni istanza Chart espone il suo nome, il tipo di grafico e la sua posizione di ancoraggio a due celle. Un nuovo grafico viene inserito con ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), che restituisce l’indice del grafico appena creato.

L’enumerazione ChartType identifica la variante del grafico (bar, line, pie, ecc.). I metodi di supporto ChartCollection.parseChartType(string) e ChartCollection.chartTypeToString(ChartType) convertono tra l’enumerazione e la sua rappresentazione stringa per casi d’uso di serializzazione.

Classi chiave

Classe	Descrizione
`Chart`	Rappresenta un grafico incorporato in un foglio di lavoro. Accesso in lettura al nome, al tipo e alla posizione di ancoraggio della cella.
`ChartCollection`	Raccolta di tutti i grafici su un foglio di lavoro. Supporta conteggio, accesso per indice, aggiunta e helper per la conversione del tipo di grafico.
`ChartType`	Enum che identifica la variante del grafico (barra, colonna, linea, torta, dispersione, ecc.).
`ChartModel`	Modello di serializzazione interno per un grafico. Espone i campi grezzi XML utilizzati durante il caricamento/salvataggio.

Accedere ai grafici su un foglio di lavoro

Recupera il ChartCollection da qualsiasi oggetto Worksheet tramite Worksheet.getCharts(). Usa ChartCollection.getCount() per determinare quanti grafici sono presenti. I grafici individuali sono accessibili tramite indice a base zero mediante ChartCollection.get(index).

Una volta che disponi di un riferimento Chart puoi leggere:

Chart.getName() — la stringa del nome interno del grafico.
Chart.getChartType() — il valore enum ChartType.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() — la cella di ancoraggio in alto a sinistra.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() — la cella di ancoraggio in basso a destra.
Chart.getExtentCx() / Chart.getExtentCy() — le dimensioni del grafico in EMU.

Aggiungere un nuovo grafico

Usa ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) per inserire un nuovo grafico. Il metodo restituisce l’indice intero del grafico all’interno della collezione. Fornisci un valore ChartType per l’argomento type e una stringa di intervallo di celle (ad esempio A1:B5) per dataRange.

Nota: i tipi della famiglia ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) vengono preservati durante il caricamento dei file XLSX ma non possono essere creati programmaticamente tramite questo API.

API Reference Riepilogo

Chart

Metodo	Tipo di ritorno	Descrizione
`getName()`	`String`	Nome interno del grafico.
`getChartType()`	`ChartType`	Il valore enum della variante del grafico.
`getUpperLeftRow()`	`int`	Indice di riga dell’ancora in alto a sinistra.
`getUpperLeftColumn()`	`int`	Indice di colonna dell’ancora in alto a sinistra.
`getLowerRightRow()`	`int`	Indice di riga dell’ancora in basso a destra.
`getLowerRightColumn()`	`int`	Indice di colonna dell’ancora in basso a destra.
`getExtentCx()`	`long`	Larghezza del grafico in EMU.
`getExtentCy()`	`long`	Altezza del grafico in EMU.

ChartCollection

Metodo	Tipo di ritorno	Descrizione
`getCount()`	`int`	Numero di grafici nel foglio di lavoro.
`get(index)`	`Chart`	Restituisce il grafico all’indice zero-based specificato.
`add(type, dataRange, ...)`	`int`	Aggiunge un nuovo grafico; restituisce il suo indice.
`parseChartType(string)`	`ChartType`	Converte un nome stringa in un valore enum `ChartType`.
`chartTypeToString(type)`	`String`	Converte un valore enum `ChartType` nel suo nome stringa.

Limitazioni

I tipi ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) vengono trasferiti integralmente ma non possono essere creati tramite il API.
Le associazioni delle serie di dati del grafico non sono modificabili in questa versione; il grafico viene renderizzato in base all’intervallo di dati originale fornito al momento della creazione.

Vedi anche

Aspose.Cells for Java — Enterprise Documentation