Использование диаграмм в Aspose.Words для Java
Введение в использование диаграмм в Aspose.Words для Java
В этом уроке мы рассмотрим, как работать с диаграммами с помощью Aspose.Words для Java. Вы узнаете, как создавать различные типы диаграмм, настраивать свойства осей, форматировать метки данных и многое другое. Давайте погрузимся!
Создание линейного графика
Чтобы создать линейную диаграмму, используйте следующий код:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0);
Chart chart = shape.getChart();
chart.getTitle().setText("Data Labels With Different Number Format");
// Удалить созданную по умолчанию серию.
chart.getSeries().clear();
// Добавление серии с данными и метками данных.
ChartSeries series1 = chart.getSeries().add("Aspose Series 1",
new String[] { "Category 1", "Category 2", "Category 3" },
new double[] { 2.5, 1.5, 3.5 });
series1.hasDataLabels(true);
series1.getDataLabels().setShowValue(true);
series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00");
series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy");
series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%");
// Или свяжите код формата с исходной ячейкой.
series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);
doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx");
Создание других типов диаграмм
Вы можете создавать различные типы диаграмм, такие как столбчатые, области, пузырьковые, точечные и другие, используя аналогичные методы. Вот пример вставки простой гистограммы:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();
// Удалить созданную по умолчанию серию.
chart.getSeries().clear();
// Создание категорий и добавление данных.
String[] categories = new String[] { "Category 1", "Category 2" };
chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 });
chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 });
doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx");
Настройка свойств оси
Вы можете настроить свойства оси, такие как изменение типа оси, установка делений, форматирование меток и многое другое. Вот пример определения свойств оси XY:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0);
Chart chart = shape.getChart();
// Очистите серию по умолчанию и добавьте свои данные.
ChartAxis xAxis = chart.getAxisX();
ChartAxis yAxis = chart.getAxisY();
// Измените ось X, чтобы она отображала категорию вместо даты.
xAxis.setCategoryType(AxisCategoryType.CATEGORY);
xAxis.setCrosses(AxisCrosses.CUSTOM);
xAxis.setCrossesAt(3.0); //Измеряется в единицах отображения по оси Y (сотни).
xAxis.setReverseOrder(true);
xAxis.setMajorTickMark(AxisTickMark.CROSS);
xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);
xAxis.setTickLabelOffset(200);
yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH);
yAxis.setMajorUnit(100.0);
yAxis.setMinorUnit(50.0);
yAxis.getDisplayUnit().setUnit(AxisBuiltInUnit.HUNDREDS);
yAxis.getScaling().setMinimum(new AxisBound(100.0));
yAxis.getScaling().setMaximum(new AxisBound(700.0));
doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx");
Форматирование меток данных
Метки данных можно форматировать в различных числовых форматах. Вот пример:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();
// Очистите серию по умолчанию и добавьте свои данные.
chart.getAxisY().getNumberFormat().setFormatCode("#,##0");
doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx");
Дополнительные настройки диаграммы
Вы можете дополнительно настроить свои диаграммы, настроив границы, интервалы между метками, скрывая оси диаграммы и т. д. Изучите предоставленные фрагменты кода, чтобы узнать больше об этих параметрах.
Заключение
В этом уроке мы рассмотрели, как работать с диаграммами с помощью Aspose.Words для Java. Вы узнали, как создавать различные типы диаграмм, настраивать свойства осей, форматировать метки данных и многое другое. Aspose.Words for Java предоставляет мощные инструменты для добавления визуальных представлений данных в ваши документы, улучшая способ представления информации.
Часто задаваемые вопросы
Как добавить на диаграмму несколько рядов?
Вы можете добавить несколько рядов в диаграмму, используяchart.getSeries().add()
метод. Обязательно укажите имя серии, категории и значения данных.
Как я могу форматировать метки данных с помощью пользовательских числовых форматов?
Вы можете форматировать метки данных, открывDataLabels
свойства серии и установка нужного кода формата с помощьюgetNumberFormat().setFormatCode()
.
Как настроить свойства оси на диаграмме?
Вы можете настроить свойства оси, такие как тип, деления, метки и т. д., открывChartAxis
такие свойства, какsetCategoryType()
, setCrosses()
, иsetMajorTickMark()
.
Как создать диаграммы других типов, например точечные диаграммы или диаграммы областей?
Вы можете создавать различные типы диаграмм, указав соответствующиеChartType
при вставке диаграммы с помощьюbuilder.insertChart(ChartType.TYPE, width, height)
.
Как скрыть ось диаграммы?
Вы можете скрыть ось диаграммы, установивsetHidden(true)
свойство оси.