Working with Charts

Робота з діаграмами

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.

Overview

Графіки на листові обробляються через систему: ChartCollection доступ через: Worksheet.getCharts().Кожна з них. Chart випадок показує своє ім’я, тип графіку;, Новий графік вставляється з ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), що повертає індекс новоствореної графіки.

У. ChartType enum визначає варіант графіку (шлях, лінія, пік і т. д.). Допоможні методи ChartCollection.parseChartType(string) і ChartCollection.chartTypeToString(ChartType) перетворювати між enum і його представлення струн для випадків використання серіалізації.

Ключові класи

Class	Description
`Chart`	Представляє вбудований графік у таблиці. Читати доступ до імені, типу та положення якоря клітини.
`ChartCollection`	Збір усіх діаграмів на робочому листі. Підтримує перерахунки, доступ до індексів, додавання та допомога конверсії типу диаграм.
`ChartType`	Енум, що визначає варіант графіку (шлях, колона, лінія, пік, розкидач і т.д.).
`ChartModel`	Внутрішня модель серіалізації для графіку. Виявляє сирі XML поля, що використовуються під час завантаження/заховування.

Доступ до графіків на планшеті

Відновити ChartCollection від будь-якого Worksheet об’єкт через Worksheet.getCharts().Використовуйте. ChartCollection.getCount() визначити, скільки окремі діаграми доступні за допомогою нульового індексу через ChartCollection.get(index).

Коли ви тримаєте Chart Свідчення, яке ви можете прочитати:

Chart.getName() внутрішній ряд імен графіку.
Chart.getChartType() в ChartType значення enum.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() верхня ліва якарна клітина.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() нижній правой ланцюговій клітинці.
Chart.getExtentCx() / Chart.getExtentCy() графік розповсюджується в ЕВМ.

Додавання нової графіки

Використання ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) Метод повертає цілий індекс графіку в межах: колекції. ChartType значення для type аргумент і ячейка. діапазон струн (наприклад, A1:B5) для dataRange.

Примітка: Типи сімейства ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) зберігаються при завантаженні файлів XLSX, але не можуть створюватися програмно через цей API.

Реферат на API

Chart

Method	Тип повернення	Description
`getName()`	`String`	Внутрішня назва графіку.
`getChartType()`	`ChartType`	Вартість варіанту enum.
`getUpperLeftRow()`	`int`	Показач ряду верхньої лівої якори.
`getUpperLeftColumn()`	`int`	Колонна-індекс верхньої лівої якори.
`getLowerRightRow()`	`int`	Індекс рядка нижньої правої якори.
`getLowerRightColumn()`	`int`	Колонна-індекс нижньої правої якори.
`getExtentCx()`	`long`	Ширина графіку в ЕВМ.
`getExtentCy()`	`long`	Висота графіку в ЕВМ.

ChartCollection

Method	Тип повернення	Description
`getCount()`	`int`	Кількість графіків на таблиці.
`get(index)`	`Chart`	Повертає діаграм на даному нульовому індексі.
`add(type, dataRange, ...)`	`int`	Додає новий графік; повертає його індекс.
`parseChartType(string)`	`ChartType`	Перераховує ім’я послідовності в `ChartType` значення enum.
`chartTypeToString(type)`	`String`	Перераховує a `ChartType` значення enum до його назви послідовності.

Limitations

Типи ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) буквально пов’язані з обкладом, але їх не можна створювати через API.
Зв’язки серії даних графіку не можуть бути змінені в цьому випуску; графіка відображається на основі оригінального діапазону даних, наданого під час створення.

Робота з діаграмами