Использование диаграмм в 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) свойство оси.