Working with Charts

Lucrul cu grafice

Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.

Prezentare generală

Diagrame într-o foaie de lucru sunt gestionate prin intermediul sistemului de gestionare a datelor. ChartCollection accesat prin intermediul: Worksheet.getCharts().Fiecare . Chart Instanța expune numele său, tipul de diagramă, O nouă diagramă este introdus cu ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), care returnează indexul noului grafic creat.

În ceea ce priveşte ChartType enum identifică varianta diagramelor (bară, linie, plăcintă etc.). Metode auxiliare ChartCollection.parseChartType(string) și de: ChartCollection.chartTypeToString(ChartType) convertit între enum și reprezentarea stringului pentru cazurile de utilizare a serializării.

Clase cheie

Clasa de învăţământ	Descriere:
`Chart`	Reprezintă un grafic încorporat într-o foaie de lucru.
`ChartCollection`	Colectare a tuturor diagramelor într-o foaie de lucru. Suportă numărarea, accesul la index, adăugarea și ajutoarele de conversie tip grafic.
`ChartType`	Enum identificând varianta diagramelor (bară, coloană, linie, plăcintă, scatter etc.).
`ChartModel`	Model intern de serializare pentru un grafic. Expune câmpurile XML brute utilizate în timpul încărcării/salvării.

Accesibilitatea diagramelor pe o foaie de lucru

Obţineţi… ChartCollection de la orice Worksheet obiectul via Worksheet.getCharts().- Foloseste-l . ChartCollection.getCount() pentru a determina cât de multe Graficele individuale sunt accesate prin index bazate pe zero, prin intermediul ChartCollection.get(index).

Odată ce ai o … Chart referință puteți citi:

Chart.getName() șirul de nume intern al diagramelor.
Chart.getChartType() în ChartType Valori enum.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() celula de ancorare din partea stângă.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() celula de ancorare din dreapta jos.
Chart.getExtentCx() / Chart.getExtentCy() graficul se extinde în UEM.

Adăugarea unui nou tabel

Utilizare: ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) metoda returnează indicele integer al diagramului în interiorul colectarea. ChartType valoarea pentru type argument și o celulă o serie de intervale (de exemplu, A1:B5) pentru: dataRange.

Notă: Tipurile din familia ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box și Whisker, Funnel, Map) sunt păstrate atunci când se încărcă fișiere XLSX dar nu pot fi create programatic prin intermediul acestui API.

Rezultatele de la data aplicării.

Graficul

Metoda de evaluare	Tip de returnare	Descriere:
`getName()`	`String`	Numele intern al fișierului.
`getChartType()`	`ChartType`	Valoarea variantă enum.
`getUpperLeftRow()`	`int`	Indicele rândului de ancoră din partea stângă.
`getUpperLeftColumn()`	`int`	Indicele coloanei de la ancoră din partea stângă.
`getLowerRightRow()`	`int`	Indicele rândului de ancoră din dreapta jos.
`getLowerRightColumn()`	`int`	Indicele coloanei de ancoră din partea dreaptă.
`getExtentCx()`	`long`	Lățimea graficului în EMU.
`getExtentCy()`	`long`	Înălțimea graficului în EMU.

ChartCollection

Metoda de evaluare	Tip de returnare	Descriere:
`getCount()`	`int`	Numărul de diagrame pe fișă.
`get(index)`	`Chart`	Întoarce graficul la indicele dat pe bază de zero.
`add(type, dataRange, ...)`	`int`	Adăuga un nou grafic; returnează indexul său.
`parseChartType(string)`	`ChartType`	Convertează un nume de șir într-un `ChartType` Valori enum.
`chartTypeToString(type)`	`String`	Convertează un `ChartType` enum valoare la numele său de șir.

Limite de aplicare

Tipurile ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) sunt rotunde literalmente dar nu pot fi create prin API.
Legăturile seriei de date ale diagramelor nu pot fi modificate în această versiune; graficul se redă pe baza intervalului original de datele furnizate la momentul creării.

Vezi și:

Aspose.Cells for Java — Enterprise Documentation