Working with Charts

Arbeta med diagram

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.

Översikt

Kartor i ett arbetsblad hanteras genom ChartCollection Tillträde via Worksheet.getCharts().Varje Chart instans visar sitt namn, diagram typ, och dess tvåcellsankornas position. en ny diagram införs med ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), som returnerar indexet för det nyligen skapade diagrammet.

Den ChartType enum identifierar diagramvarianten (bar, linje, pie etc.). Hjälper metoder ChartCollection.parseChartType(string) och ChartCollection.chartTypeToString(ChartType) konverterar mellan enum och dess strängrepresentation för serialisering användning fall.

Viktiga klasser

Class	Beskrivning
`Chart`	Representerar en inbyggd diagram i ett arbetsblad. Läs tillgång till namn, typ och cell-anchor position.
`ChartCollection`	Samla alla diagram på en arbetsblock. Stödjer räkning, indexåtkomst, tillägg och hjälpmedel för konvertering av diagrammtyp.
`ChartType`	Enum identifierar diagramvarianten (bar, kolumn, linje, pie, scatter etc.).
`ChartModel`	Internal serialisering modell för en diagram. Exponerar rå XML-fält som används under laddning/spara.

Tillgång till diagram på ett arbetsblad

återställer den ChartCollection Från någon Worksheet Objekt via Worksheet.getCharts().Användning ChartCollection.getCount() För att avgöra hur många Individerna är tillgängliga via nollbaserad index genom att ChartCollection.get(index).

När du håller en Chart Referens du kan läsa:

Chart.getName() - den interna namnsfältet i diagrammet.
Chart.getChartType() - den ChartType Enum värde .
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() - den övre vänstra anchorcellen.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() - den nedre höger ankorcellen.
Chart.getExtentCx() / Chart.getExtentCy() - kartan sträcker sig i EMU.

Lägg till en ny karta

Användning ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) för att ange en ny diagram. Metoden returnerar den totala indexet i diagrammet inom samlingen. ge en ChartType Värde för den type Argument och en cell Range string (till exempel) A1:B5) för dataRange.

Obs!: ChartEx-familjstyper (Waterfall, Treemap, Sunburst, Histogram, Box och Whisker, Funnel, Map) bevaras när du laddar XLSX-filer men kan inte skapas programmatiskt via denna API.

API Referens sammanfattning

Chart

Method	Tillbaka typ	Beskrivning
`getName()`	`String`	Internt namn på kartan.
`getChartType()`	`ChartType`	Varianten varierar enum värde.
`getUpperLeftRow()`	`int`	Råindexet av den övre vänstra anchor.
`getUpperLeftColumn()`	`int`	Kolumnen index av den övre vänstra anchor.
`getLowerRightRow()`	`int`	Råindexet av den nedre högerankaren.
`getLowerRightColumn()`	`int`	Kolumnen index av den nedre höger anchor.
`getExtentCx()`	`long`	Kartor bredd i EMU.
`getExtentCy()`	`long`	Karta höjd i EMU.

ChartCollection

Method	Tillbaka typ	Beskrivning
`getCount()`	`int`	Antalet diagram på arbetsbladen.
`get(index)`	`Chart`	Returnerar diagrammet till den angivna nollbaserade indexet.
`add(type, dataRange, ...)`	`int`	Lägg till en ny diagram; returnerar dess index.
`parseChartType(string)`	`ChartType`	Konverterar ett stringnamn till en `ChartType` Enum värde .
`chartTypeToString(type)`	`String`	Konverterar A `ChartType` enum värde till dess stringnamn.

Begränsningar

ChartEx-typer (Waterfall, Treemap, Sunburst, Histogram, Box och Whisker, Funnel, Map) är runda trånga verbatim men kan inte skapas via API.
Kartdata serien bindningar är inte modifierbara i denna version; kart renderer baserat på det ursprungliga dataserien som levereras vid skapandet.

Se även

Aspose.Cells for Java — Enterprise Documentation