Настройка диаграмм
Создание диаграмм
С помощью Aspose.Cells можно добавлять различные типы диаграмм в электронные таблицы. Aspose.Cells предоставляет множество гибких объектов диаграмм. В этой теме обсуждаются объекты диаграмм Aspose.Cells.
Простое создание диаграммы
Просто создать диаграмму с Aspose.Cells с помощью следующих примеров кода:
Важные моменты для создания диаграммы
Прежде чем создавать диаграммы, важно понимать некоторые основные концепции, которые полезны при создании диаграмм с использованием Aspose.Cells.
Объекты диаграммирования
Aspose.Cells предоставляет специальный набор классов, используемых для создания всех видов диаграмм. Эти классы используются для создания объектов диаграммирования, которые выступают в качестве строительных блоков диаграммы. Объекты диаграммирования перечислены ниже:
- Axis, ось диаграммы.
- Chart, одна диаграмма Excel.
- ChartArea, область диаграммы на листе.
- ChartDataTable, таблица данных диаграммы.
- ChartFrame, объект рамки на диаграмме.
- ChartPoint, одна точка в серии на диаграмме.
- ChartPointCollection, коллекция, содержащая все точки одной серии.
- ChartCollection, коллекция объектов Chart.
- DataLabels, подписи данных для указанного Series, ChartPoint, Trendline и т. д.
- FillFormat, формат заливки для формы.
- Floor, основание 3D-диаграммы.
- Legend, легенда диаграммы.
- Line, линия диаграммы.
- SeriesCollection, коллекция объектов Series.
- Series, представляет одну серию данных на диаграмме.
- TickLabels, метки делений, связанные с делениями оси диаграммы.
- Title, заголовок диаграммы или оси.
- Trendline, линия тренда на диаграмме.
- TrendlineCollection, набор всех объектов Trendline для указанной серии данных.
- Walls, стены 3D-графика.
Использование объектов построения диаграмм
Как уже упоминалось, все объекты построения диаграмм являются экземплярами соответствующих классов и обладают конкретными свойствами и методами для выполнения определенных задач. Используйте объекты построения диаграмм для создания диаграмм.
Добавьте любой тип диаграммы на лист с использованием коллекции ChartCollection. Каждый элемент в коллекции ChartCollection представляет объект Chart. Объект Chart инкапсулирует все объекты диаграммирования, необходимые для настройки внешнего вида диаграммы. В следующем разделе показано, как использовать несколько основных объектов диаграммирования для создания простой диаграммы.
Создание простой диаграммы
С помощью Aspose.Cells можно создавать множество различных типов диаграмм. Все стандартные диаграммы, поддерживаемые Aspose.Cells, предопределены в перечислении с именем ChartType. Предопределенные типы диаграмм:
| Типы графиков | Описание |
|---|---|
| Column | Представляет диаграмму столбцов в кластере |
| ColumnStacked | Представляет стопку гистограмму |
| Column100PercentStacked | Представляет 100% стопку гистограмму |
| Column3DClustered | Представляет 3D гистограмму с кластеризацией |
| Column3DStacked | Представляет 3D стопку гистограмму |
| Column3D100PercentStacked | Представляет 3D 100% стопку гистограмму |
| Column3D | Представляет 3D гистограмму |
| Bar | Представляет гистограмму с кластеризацией по горизонтали |
| BarStacked | Представляет стопку гистограмму по горизонтали |
| Bar100PercentStacked | Представляет 100% стопку гистограмму по горизонтали |
| Bar3DClustered | Представляет 3D гистограмму с кластеризацией по горизонтали |
| Bar3DStacked | Представляет 3D стопку гистограмму по горизонтали |
| Bar3D100PercentStacked | Представляет 3D 100% стопку гистограмму по горизонтали |
| Line | Представляет линейный график |
| LineStacked | Представляет стопку линейный график |
| Line100PercentStacked | Представляет 100% стопку линейный график |
| LineWithDataMarkers | Представляет линейный график с маркерами данных |
| LineStackedWithDataMarkers | Представляет стопку линейный график с маркерами данных |
| Line100PercentStackedWithDataMarkers | Представляет собой 100% столбчатую диаграмму с маркерами данных |
| Line3D | Представляет собой 3D линейную диаграмму |
| Pie | Представляет собой круговую диаграмму |
| Pie3D | Представляет собой 3D круговую диаграмму |
| PiePie | Представляет собой круговую диаграмму с вложенной круговой диаграммой |
| PieExploded | Представляет собой взорванную круговую диаграмму |
| Pie3DExploded | Представляет собой 3D взорванную круговую диаграмму |
| PieBar | Представляет собой столбчатую диаграмму с вложенной круговой диаграммой |
| Scatter | Представляет диаграмму рассеяния |
| ScatterConnectedByCurvesWithDataMarker | Представляет диаграмму рассеяния, соединенную кривыми, с маркерами данных |
| ScatterConnectedByCurvesWithoutDataMarker | Представляет диаграмму рассеяния, соединенную кривыми, без маркеров данных |
| ScatterConnectedByLinesWithDataMarker | Представляет диаграмму рассеяния, соединенную линиями, с маркерами данных |
| ScatterConnectedByLinesWithoutDataMarker | Представляет диаграмму рассеяния, соединенную линиями, без маркеров данных |
| Area | Представляет собой зонную диаграмму |
| AreaStacked | Представляет собой стопку зонную диаграмму |
| Area100PercentStacked | Представляет собой 100% стопку зонную диаграмму |
| Area3D | Представляет собой 3D зонную диаграмму |
| Area3DStacked | Представляет собой 3D стопку зонную диаграмму |
| Area3D100PercentStacked | Представляет собой 3D 100% стопку зонную диаграмму |
| Doughnut | Представляет собой донат-диаграмму |
| DoughnutExploded | Представляет круговую диаграмму со сдвоенной дугой |
| Radar | Представляет радарную диаграмму |
| RadarWithDataMarkers | Представляет радарную диаграмму с маркерами данных |
| RadarFilled | Представляет заполненную радарную диаграмму |
| Surface3D | Представляет трехмерную поверхностную диаграмму |
| SurfaceWireframe3D | Представляет жесткую 3D поверхностную диаграмму |
| SurfaceContour | Представляет контурную диаграмму |
| SurfaceContourWireframe | Представляет проволочную контурную диаграмму |
| Bubble | Представляет диаграмму пузырьков |
| Bubble3D | Представляет трехмерную диаграмму пузырьков |
| Cylinder | Представляет цилиндрическую диаграмму |
| CylinderStacked | Представляет стопку цилиндрических диаграмм |
| Cylinder100PercentStacked | Представляет 100% стопку цилиндрических диаграмм |
| CylindricalBar | Представляет цилиндрическую столбчатую диаграмму. |
| CylindricalBarStacked | Представляет стопку цилиндрических столбчатых диаграмм |
| CylindricalBar100PercentStacked | Представляет 100% стопку цилиндрических столбчатых диаграмм |
| CylindricalColumn3D | Представляет трехмерную цилиндрическую диаграмму |
| Cone | Представляет конусную диаграмму |
| ConeStacked | Представляет стопку конусных диаграмм |
| Cone100PercentStacked | Представляет 100% стопку конусных диаграмм |
| ConicalBar | Представляет коническую столбчатую диаграмму |
| ConicalBarStacked | Представляет стопку конических столбчатых диаграмм |
| ConicalBar100PercentStacked | Представляет 100% стопку конических столбчатых диаграмм |
| ConicalColumn3D | Представляет 3D коническую колонную диаграмму |
| Pyramid | Представляет пирамидальную диаграмму |
| PyramidStacked | Представляет стопку пирамидальных диаграмм |
| Pyramid100PercentStacked | Представляет 100% стопку пирамидальных диаграмм |
| PyramidBar | Представляет пирамидальную столбчатую диаграмму |
| PyramidBarStacked | Представляет стопку пирамидальных столбчатых диаграмм |
| PyramidBar100PercentStacked | Представляет 100% стопку пирамидальных столбчатых диаграмм |
| PyramidColumn3D | Представляет 3D пирамидальную колонную диаграмму |
| Для создания диаграммы с помощью Aspose.Cells: |
- Добавьте некоторые данные в ячейки листа с помощью метода setValue объекта Cell. Это будет использоваться в качестве источника данных для диаграммы.
- Добавьте график на лист, вызвав метод add коллекции ChartCollection, инкапсулированной в объекте Worksheet.
- Укажите тип диаграммы с помощью перечисления ChartType. Например, в примере используется значение ChartType.PYRAMID в качестве типа графика.
- Получите доступ к новому объекту Chart из коллекции ChartCollection, передав его индекс.
- Используйте любой объект построения диаграмм, инкапсулированный в объекте Chart, для управления диаграммой. В приведенном ниже примере используется объект построения диаграммы SeriesCollection для указания источника данных диаграммы.
При добавлении исходных данных на диаграмму источник данных может быть диапазоном ячеек (например, “A1:C3”), или последовательностью непрерывных ячеек (например, “A1, A3, A5”), или последовательностью значений (например, “1,2,3”).
Эти общие шаги позволяют создать любой тип диаграммы. Используйте различные объекты построения диаграмм для создания различных диаграмм.
При выполнении примерного кода на лист добавляется пирамидальный график, как показано на рисунке ниже.
Пирамидальный график с его источником данных
Чтобы создать график пузырьков, ChartType должен быть установлен на ChartType.BUBBLE, и несколько дополнительных свойств, таких как BubbleSizes, Values и XValues, должны быть установлены соответственно. После выполнения следующего кода на лист добавляется график пузырьков, как показано на рисунке ниже.
График пузырьков с его источником данных
Диаграмма линии с маркерами данных
Для создания линейного графика с маркерами данных ChartType должен быть установлен на ChartType.LINE_WITH_DATA_MARKERS, и несколько дополнительных свойств, таких как область фона, маркеры ряда, значения и XValues должны быть установлены соответственно. После выполнения следующего кода на лист добавляется линейный график с маркерами данных, как показано на рисунке ниже.
Создание настраиваемых диаграмм
До сих пор, когда мы говорили о графиках, мы рассматривали стандартные графики, которые имеют свои стандартные настройки форматирования. Мы только определяем источник данных, устанавливаем несколько свойств, и график создается с его форматными настройками по умолчанию. Но Aspose.Cells также поддерживает создание пользовательских графиков, что позволяет разработчикам создавать графики с их собственными настройками форматирования.
Создание настраиваемых диаграмм
Разработчики могут создавать пользовательские графики во время выполнения с помощью простого API Aspose.Cells.
График состоит из серии данных. Каждая серия данных в Aspose.Cells представлена объектом Series, в то время как объект SeriesCollection служит коллекцией объектов Series. При создании пользовательского графика разработчики могут использовать различные типы графиков для различных серий данных (собранных в объекте SeriesCollection).
Приведенный ниже пример кода демонстрирует, как создать пользовательские графики. В этом примере мы собираемся использовать столбчатую диаграмму для первой серии данных и линейную диаграмму для второй серии. Результатом будет добавление столбчатой диаграммы, объединенной с линейной диаграммой, на лист.
Пользовательская диаграмма, объединяющая столбцовую и линейную диаграммы
Пример программирования