Diagramok kezelése
Diagramok kezelése
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.
Áttekintés
A munkalapok diagramjait a ChartCollection hozzáférhető a Worksheet.getCharts().- Mindenki. Chart a példány neve, diagramtípus;, A két sejtes rögzítési pozícióval egy új táblázat kerül beillesztésre. ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), ami az újonnan létrehozott grafikon indexét adja vissza.
A Bizottság ChartType az enum azonosítja a táblázat változatait (sáv, vonal, pitta stb.). Segítő módszerek ChartCollection.parseChartType(string) és a következők: ChartCollection.chartTypeToString(ChartType) átváltva az enum és a a sorozatosításhoz szükséges szalagképzés.
Kulcsosztályok
| Az osztály | Leírás |
|---|---|
Chart | A beágyazott táblázat egy munkalapban. Olvass hozzáférést a névhez, típushoz és cellák rögzítési pozíciójához. |
ChartCollection | A munkalap összes táblázatának gyűjteménye. Támogatja a számlálást, az indexhez való hozzáférést, a hozzáadást és a tábla-típusú konvertációs segédeket. |
ChartType | A táblázat változata azonosító szám (sáv, oszlop, sor, pité, szétterelés stb.). |
ChartModel | A grafikon belső sorozatmodellje. Nyomtatja a betöltés/megőrzés során használt nyers XML mezőket. |
A táblázatok elérése a munkalapon
Vissza a… ChartCollection bármelyikből. Worksheet objektum átadása Worksheet.getCharts().Használja. ChartCollection.getCount() hogy eldöntsük, hány Az egyes grafikonokhoz a nullázott index hozzáférhet az interneten keresztül. ChartCollection.get(index).
Ha egyszer elkapsz egy… Chart hivatkozás, amit olvashat:
Chart.getName()a táblázat belső névsorája.Chart.getChartType()aChartTypeenum érték.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()A bal felső sarokszobában.Chart.getLowerRightRow()/Chart.getLowerRightColumn()A jobb alsó sarokszobában.Chart.getExtentCx()/Chart.getExtentCy()a grafikon EMU-ban terjed.
Új táblázat hozzáadása
Használat ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) A módszer a grafikon egészszámát adja vissza. A gyűjtés. ChartType érték a type argument és cellát. tartományos szalag (például: A1:B5) a következőkben: dataRange.
Megjegyzés: A ChartEx-család típusok (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) megmaradnak az XLSX fájlok betöltésekor, de nem hozhatók létre programszerűen ezen API segítségével.
API-referencia összefoglaló
Táblázat
| Módszer | Visszaadási típus | Leírás |
|---|---|---|
getName() | String | A táblázat belső neve. |
getChartType() | ChartType | A táblázat változata enum érték. |
getUpperLeftRow() | int | A bal felső saroknyira. |
getUpperLeftColumn() | int | A bal felső sarokszem. |
getLowerRightRow() | int | Az alsó jobb oldalon lévő horgony sorszám. |
getLowerRightColumn() | int | A jobb alsó sarokszem. |
getExtentCx() | long | A grafikon szélessége EMU-ban. |
getExtentCy() | long | A grafikon magassága EMU-ban. |
ChartCollection
| Módszer | Visszaadási típus | Leírás |
|---|---|---|
getCount() | int | A táblázat számát a munkalapon. |
get(index) | Chart | Az adott nullás indexben a táblázatot adja vissza. |
add(type, dataRange, ...) | int | Új táblázatot ad hozzá, és az indexet adja vissza. |
parseChartType(string) | ChartType | A szalag nevét a sorba alakítja át. ChartType enum érték. |
chartTypeToString(type) | String | Átalakítja a ChartType a szalagnévhez. |
Korlátozások
- A ChartEx típusok (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) szó szerint körbejárhatók, de nem hozhatók létre az API-n keresztül.
- A táblázat adatsorozatainak kötései nem módosíthatók ebben a kiadásban; a tábla megjelenítése az eredeti adattartományon alapul, amelyet a létrehozás időpontjában biztosítottak.
