Práce s grafy
Práce s grafy
Aspose.Cells FOSS pro Java zachovává vložené grafy při načítání a ukládání sešitů XLSX. Můžete prohlížet existující grafy, dotazovat se na jejich typ a pozici a programově přidávat nové standardní grafy. Typy ChartEx, jako jsou Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel a Map, jsou při průchodu zachovány, ale nelze je vytvořit pomocí API.
Přehled
Grafy v listu jsou spravovány prostřednictvím ChartCollection přístupného přes Worksheet.getCharts(). Každá instance Chart odhaluje svůj název, typ grafu a jeho dvoubuňkovou kotvu. Nový graf je vložen pomocí ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), který vrací index nově vytvořeného grafu.
Výčtový typ ChartType určuje variantu grafu (sloupcový, čárový, koláčový atd.). Pomocné metody ChartCollection.parseChartType(string) a ChartCollection.chartTypeToString(ChartType) převádějí mezi výčtem a jeho řetězcovou reprezentací pro účely serializace.
Klíčové třídy
| Třída | Popis: |
|---|---|
Chart | Představuje vložený graf v listu. Poskytuje pouze čtecí přístup k názvu, typu a pozici kotvy buňky. |
ChartCollection | Sbírka všech grafů v listu. Podporuje počítání, přístup podle indexu, přidávání a pomocníky pro konverzi typu grafu. |
ChartType | Výčet určující variantu grafu (pruhový, sloupcový, čárový, koláčový, rozptýlený atd.). |
ChartModel | Interní model serializace pro graf. Zpřístupňuje surová pole XML používaná během načítání/ukládání. |
Přístup ke grafům na listu
Získejte ChartCollection z libovolného objektu Worksheet pomocí Worksheet.getCharts(). Použijte ChartCollection.getCount() k určení počtu existujících grafů. Individuální grafy jsou přístupné pomocí nulového indexu přes ChartCollection.get(index).
Jakmile máte referenci Chart, můžete číst:
Chart.getName()— interní řetězec názvu grafu.Chart.getChartType()— hodnota výčtuChartType.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()— buňka v levém horním rohu.Chart.getLowerRightRow()/Chart.getLowerRightColumn()— buňka v pravém dolním rohu.Chart.getExtentCx()/Chart.getExtentCy()— rozměry grafu v EMU.
Přidání nového grafu
Použijte ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) k vložení nového grafu. Metoda vrací celočíselný index grafu v kolekci. Poskytněte hodnotu ChartType pro argument type a řetězec rozsahu buněk (například A1:B5) pro dataRange.
Poznámka: typy ChartEx-family (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) jsou při načítání souborů XLSX zachovány, ale nelze je programově vytvořit pomocí tohoto API.
API Reference Shrnutí
Chart
| Metoda | Typ vrácení | Popis: |
|---|---|---|
getName() | String | Interní název grafu. |
getChartType() | ChartType | Hodnota výčtu varianty grafu. |
getUpperLeftRow() | int | Index řádku levé horní kotvy. |
getUpperLeftColumn() | int | Index sloupce levé horní kotvy. |
getLowerRightRow() | int | Index řádku pravého dolního kotvy. |
getLowerRightColumn() | int | Index sloupce pravého dolního kotvy. |
getExtentCx() | long | Šířka grafu v EMUs. |
getExtentCy() | long | Výška grafu v EMUs. |
ChartCollection
| Metoda | Typ vrácení | Popis: |
|---|---|---|
getCount() | int | Počet grafů na listu. |
get(index) | Chart | Vrátí graf na zadaném indexu počínajícím nulou. |
add(type, dataRange, ...) | int | Přidá nový graf; vrátí jeho index. |
parseChartType(string) | ChartType | Převede řetězcový název na hodnotu výčtu ChartType. |
chartTypeToString(type) | String | Převede hodnotu výčtu ChartType na jeho řetězcový název. |
Omezení
- Typy ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) jsou přeneseny doslovně, ale nelze je vytvořit pomocí API.
- Vazby datových řad grafu nejsou v tomto vydání upravitelné; graf se vykresluje na základě původního rozsahu dat poskytnutého při vytvoření.
