使用图表

新的insertChart方法被添加到DocumentBuilder类中。 所以，让我们看看如何使用insertChart方法将简单的柱形图插入到文档中。

如何使用Aspose.Words从头开始插入图表

在本节中，我们将学习如何将图表插入到文档中。

插入柱形图

下面的代码示例演示如何插入柱形图:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Add chart with default data. You can specify different chart types and sizes.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);

// Chart property of Shape contains all chart related options.
Chart chart = shape.getChart();

// Get chart series collection.
ChartSeriesCollection seriesColl = chart.getSeries();

// Delete default generated series.
seriesColl.clear();

// Create category names array, in this example we have two categories.
String[] categories = new String[]{"AW Category 1", "AW Category 2"};

// Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
seriesColl.add("AW Series 1", categories, new double[]{1, 2});
seriesColl.add("AW Series 2", categories, new double[]{3, 4});
seriesColl.add("AW Series 3", categories, new double[]{5, 6});
seriesColl.add("AW Series 4", categories, new double[]{7, 8});
seriesColl.add("AW Series 5", categories, new double[]{9, 10});

doc.save(dataDir + "TestInsertChartColumn1_out.docx");

代码产生以下结果:

Series Add方法有四种不同的重载，这些重载被公开以涵盖所有图表类型的数据源的所有可能变体:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Column chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Use this overload to add series to any type of Bar, Column, Line and Surface charts.
chart.getSeries().add("AW Series 1", new String[]{"AW Category 1", "AW Category 2"}, new double[]{1, 2});

doc.save(dataDir + "TestInsertColumnChart2_out.docx");

代码产生以下结果:

插入散点图

下面的代码示例演示如何插入散点图:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Scatter chart.
Shape shape = builder.insertChart(ChartType.SCATTER, 432, 252);
Chart chart = shape.getChart();

// Use this overload to add series to any type of Scatter charts.
chart.getSeries().add("AW Series 1", new double[]{0.7, 1.8, 2.6}, new double[]{2.7, 3.2, 0.8});

doc.save(dataDir + "TestInsertScatterChart_out.docx");

代码产生以下结果:

插入面积图

下面的代码示例演示如何插入面积图:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Area chart.
Shape shape = builder.insertChart(ChartType.AREA, 432, 252);
Chart chart = shape.getChart();

SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy");
Date date1 = sdf.parse("01/01/2016");
Date date2 = sdf.parse("02/02/2016");
Date date3 = sdf.parse("03/03/2016");
Date date4 = sdf.parse("04/04/2016");
Date date5 = sdf.parse("05/05/2016");

// Use this overload to add series to any type of Area, Radar and Stock charts.
chart.getSeries().add("AW Series 1", new Date[]{date1, date2, date3, date4, date5}, new double[]{32, 32, 28, 12, 15});

doc.save(dataDir + "TestInsertAreaChart_out.docx");

代码产生以下结果:

插入气泡图

下面的代码示例演示如何插入气泡图:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Bubble chart.
Shape shape = builder.insertChart(ChartType.BUBBLE, 432, 252);
Chart chart = shape.getChart();

// Use this overload to add series to any type of Bubble charts.
chart.getSeries().add("AW Series 1", new double[]{0.7, 1.8, 2.6}, new double[]{2.7, 3.2, 0.8}, new double[]{10, 4, 8});

doc.save(dataDir + "TestInsertBubbleChart_out.docx");

代码产生以下结果:

通过Shape.Chart对象处理图表

一旦图表被插入并填充了数据，您就可以改变它的外观。 Shape.Chart属性包含通过公共API提供的所有图表相关选项。

例如，让我们更改图表标题或图例行为:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.insertChart(ChartType.LINE, 432, 252);
Chart chart = shape.getChart();

// Determines whether the title shall be shown for this chart. Default is true.
chart.getTitle().setShow(true);

// Setting chart Title.
chart.getTitle().setText("Sample Line Chart Title");

// Determines whether other chart elements shall be allowed to overlap title.
chart.getTitle().setOverlay(false);

// Please note if null or empty value is specified as title text, auto generated title will be shown.

// Determines how legend shall be shown for this chart.
chart.getLegend().setPosition(LegendPosition.LEFT);
chart.getLegend().setOverlay(true);

doc.save(dataDir + "ChartAppearance_out.docx");

代码生成如下结果:

如何使用图表的ChartSeriesCollection

让我们来看看ChartSeries集合。 所有图表系列都可以通过chart.getSeries()集合获得，即Iterable:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.LINE, 432, 252);
// Chart property of Shape contains all chart related options.
Chart chart = shape.getChart();

// Get chart series collection.
ChartSeriesCollection seriesCollection = chart.getSeries();

// Check series count.
System.out.println(seriesCollection.getCount());

您可以逐个删除系列或清除所有系列，并在需要时添加新系列。 新插入的图表有一些默认序列添加到此集合中。 要删除它们，您需要调用**chart.getSeries().clear()**方法。

使用单个ChartSeries类

以下是如何使用特定系列。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.insertChart(ChartType.LINE, 432, 252);

// Get first series.
ChartSeries series0 = shape.getChart().getSeries().get(0);

// Get second series.
ChartSeries series1 = shape.getChart().getSeries().get(1);

// Change first series name.
series0.setName("My Name1");

// Change second series name.
series1.setName("My Name2");

// You can also specify whether the line connecting the points on the chart shall be smoothed using Catmull-Rom splines.
series0.setSmooth(true);
series1.setSmooth(true);

doc.save(dataDir + "SingleChartSeries_out.docx");

请参阅下面的结果:

所有单个ChartSeries都有默认的ChartDataPoint选项，请尝试使用以下代码更改它们:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.insertChart(ChartType.LINE, 432, 252);

// Get first series.
ChartSeries series0 = shape.getChart().getSeries().get(0);

// Get second series.
ChartSeries series1 = shape.getChart().getSeries().get(1);

// Specifies whether by default the parent element shall inverts its colors if the value is negative.
series0.setInvertIfNegative(true);

// Set default marker symbol and size.
series0.getMarker().setSymbol(MarkerSymbol.CIRCLE);
series0.getMarker().setSize(15);

series1.getMarker().setSymbol(MarkerSymbol.STAR);
series1.getMarker().setSize(10);

doc.save(dataDir + "ChartDataPoints_out.docx");//

如何使用ChartSeries的单个ChartDataPoint

使用ChartDataPoint，您可以自定义图表系列的单个数据点的格式:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.insertChart(ChartType.LINE, 432, 252);

// Get first series.
ChartSeries series0 = shape.getChart().getSeries().get(0);

// Get second series.
ChartSeries series1 = shape.getChart().getSeries().get(1);

ChartDataPointCollection dataPointCollection = series0.getDataPoints();

// Add data point to the first and second point of the first series.
ChartDataPoint dataPoint00 = dataPointCollection.add(0);
ChartDataPoint dataPoint01 = dataPointCollection.add(1);

// Set explosion.
dataPoint00.setExplosion(50);

// Set marker symbol and size.
dataPoint00.getMarker().setSymbol(MarkerSymbol.CIRCLE);
dataPoint00.getMarker().setSize(15);

dataPoint01.getMarker().setSymbol(MarkerSymbol.DIAMOND);
dataPoint01.getMarker().setSize(20);

// Add data point to the third point of the second series.
ChartDataPoint dataPoint12 = series1.getDataPoints().add(2);
dataPoint12.setInvertIfNegative(true);
dataPoint12.getMarker().setSymbol(MarkerSymbol.STAR);
dataPoint12.getMarker().setSize(20);

doc.save(dataDir + "SingleChartDataPointOfAChartSeries_out.docx");

请参阅下面的结果:

如何使用单个ChartSeries的ChartDataLabel

使用ChartDataLabel，您可以指定图表系列的单个数据标签的格式，如显示/隐藏LegendKey, CategoryName, SeriesName, 价值等:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.BAR, 432, 252);

// Get first series.
ChartSeries series0 = shape.getChart().getSeries().get(0);

series0.hasDataLabels(true);

// Set properties.
series0.getDataLabels().setShowLegendKey(true);

// By default, when you add data labels to the data points in a pie chart, leader lines are displayed for data labels that are
// positioned far outside the end of data points. Leader lines create a visual connection between a data label and its
// corresponding data point.
series0.getDataLabels().setShowLeaderLines(true);

series0.getDataLabels().setShowCategoryName(false);
series0.getDataLabels().setShowPercentage(false);
series0.getDataLabels().setShowSeriesName(true);
series0.getDataLabels().setShowValue(true);
series0.getDataLabels().setSeparator("/");

series0.getDataLabels().setShowValue(true);

		doc.save(dataDir + "ChartDataLabelOfASingleChartSeries_out.docx");

请参阅下面的结果:

如何为ChartSeries的ChartDataLabels定义默认选项

ChartDataLabelCollection类定义可用于为图表Series设置ChartDataLabels的默认选项的属性。 这些属性包括setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShowValue 等:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.insertChart(ChartType.PIE, 432, 252);
Chart chart = shape.getChart();
chart.getSeries().clear();

ChartSeries series = chart.getSeries().add("Series 1", new String[] { "Category1", "Category2", "Category3" },
		new double[] { 2.7, 3.2, 0.8 });

ChartDataLabelCollection labels = series.getDataLabels();
labels.setShowPercentage(true);
labels.setShowValue(true);
labels.setShowLeaderLines(false);
labels.setSeparator(" - ");

doc.save(dataDir + "Demo.docx");

请参阅下面的结果:

如何格式化图表数据标签的数量

使用NumberFormat属性，可以指定图表的单个数据标签的数字格式。

下面的代码示例演示如何格式化数据标签的数字:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java

		Document doc = new Document();
		DocumentBuilder builder = new DocumentBuilder(doc);

		// Add chart with default data.
		Shape shape = builder.insertChart(ChartType.LINE, 432, 252);
		Chart chart = shape.getChart();
		chart.getTitle().setText("Data Labels With Different Number Format");

		// Delete default generated series.
		chart.getSeries().clear();

		// Add new series
		ChartSeries series0 = chart.getSeries().add("AW Series 0", new String[] { "AW0", "AW1", "AW2" },
				new double[] { 2.5, 1.5, 3.5 });
		series0.hasDataLabels(true);

		// Set currency format code.
		series0.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00");

		// Set date format code.
		series0.getDataLabels().get(1).getNumberFormat().setFormatCode("d/mm/yyyy");

		// Set percentage format code.
		series0.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%");

		// Or you can set format code to be linked to a source cell,
		// in this case NumberFormat will be reset to general and inherited from a
		// source cell.
		series0.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);

		doc.save(dataDir + "NumberFormat_DataLabel_out.docx");

如何设置图表轴属性

如果要为值轴处理图表轴、缩放和显示单位，请使用ChartAxis、AxisDisplayUnit和AxisScaling类。

下面的代码示例演示如何定义X和Y轴属性:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java

        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

        // Insert chart.
        Shape shape = builder.insertChart(ChartType.AREA, 432, 252);
        Chart chart = shape.getChart();

        // Clear demo data.
        chart.getSeries().clear();

        // Fill data.
        chart.getSeries().add("AW Series 1",
                new Date[]{new Date(2002, 1, 1), new Date(2002, 6, 1), new Date(2015, 7, 1), new Date(2015, 8, 1), new Date(2015, 9, 1)},
                new double[]{640, 320, 280, 120, 150});

        ChartAxis xAxis = chart.getAxisX();
        ChartAxis yAxis = chart.getAxisY();

        // Change the X axis to be category instead of date, so all the points will be put with equal interval on the X axis.
        xAxis.setCategoryType(AxisCategoryType.CATEGORY);

        // Define X axis properties.
        xAxis.setCrosses(AxisCrosses.CUSTOM);
        xAxis.setCrossesAt(3); // measured in display units of the Y axis (hundreds)
        xAxis.setReverseOrder(true);
        xAxis.setMajorTickMark(AxisTickMark.CROSS);
        xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);
        xAxis.setTickLabelOffset(200);

        // Define Y axis properties.
        yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH);
        yAxis.setMajorUnit(100);
        yAxis.setMinorUnit(50);
        yAxis.getDisplayUnit().setUnit(AxisBuiltInUnit.HUNDREDS);
        yAxis.getScaling().setMinimum(new AxisBound(100));
        yAxis.getScaling().setMaximum(new AxisBound(700));

        dataDir = dataDir + "SetAxisProperties_out.docx";
        doc.save(dataDir);

如何设置轴的DateTime值

下面的代码示例演示如何将日期/时间值设置为轴属性:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

// Fill data.
chart.getSeries().add("AW Series 1",
        new Date[]{new Date(2017, 11, 06), new Date(2017, 11, 9), new Date(2017, 11, 15),
                new Date(2017, 11, 21), new Date(2017, 11, 25), new Date(2017, 11, 29)},
        new double[]{1.2, 0.3, 2.1, 2.9, 4.2, 5.3}
);

// Set X axis bounds.
ChartAxis xAxis = chart.getAxisX();
xAxis.getScaling().setMinimum(new AxisBound(new Date(2017, 11, 5).getTime()));
xAxis.getScaling().setMaximum(new AxisBound(new Date(2017, 12, 3).getTime()));

// Set major units to a week and minor units to a day.
xAxis.setMajorUnit(7);
xAxis.setMinorUnit(1);
xAxis.setMajorTickMark(AxisTickMark.CROSS);
xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);

dataDir = dataDir + "SetDateTimeValuesToAxis_out.docx";
doc.save(dataDir);

如何格式化轴的数值

下面的代码示例演示如何更改值轴上的数字格式:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

// Fill data.
chart.getSeries().add("AW Series 1",
        new String[]{"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"},
        new double[]{1900000, 850000, 2100000, 600000, 1500000});

// Set number format.
chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

dataDir = dataDir + "FormatAxisNumber_out.docx";
doc.save(dataDir);

如何设置轴的边界

AxisBound类表示轴值的最小值或最大值。 绑定可以指定为数字，日期时间或特殊的"自动"值。

下面的代码示例演示如何设置轴的边界:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

// Fill data.
chart.getSeries().add("AW Series 1",
        new String[]{"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"},
        new double[]{1.2, 0.3, 2.1, 2.9, 4.2});

chart.getAxisY().getScaling().setMinimum(new AxisBound(0));
chart.getAxisY().getScaling().setMaximum(new AxisBound(6));

dataDir = dataDir + "SetboundsOfAxis_out.docx";
doc.save(dataDir);

如何设置标签之间的间隔单位

下面的代码示例演示如何设置轴上标签之间的间隔单位:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

// Fill data.
chart.getSeries().add("AW Series 1",
        new String[]{"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"},
        new double[]{1.2, 0.3, 2.1, 2.9, 4.2});

chart.getAxisX().setTickLabelSpacing(2);

dataDir = dataDir + "SetIntervalUnitBetweenLabelsOnAxis_out.docx";
doc.save(dataDir);

如何隐藏图表轴

如果要显示或隐藏图表轴，只需通过设置ChartAxis.Hidden属性的值即可实现此目的。

下面的代码示例演示如何隐藏图表的Y轴:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

// Fill data.
chart.getSeries().add("AW Series 1",
        new String[]{"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"},
        new double[]{1.2, 0.3, 2.1, 2.9, 4.2});

// Hide the Y axis.
chart.getAxisY().setHidden(true);

dataDir = dataDir + "HideChartAxis_out.docx";
doc.save(dataDir);

如何对齐图表标签

如果要为多行标签设置文本对齐方式，可以通过设置setTickLabelAlignment()属性的值来简单地实现这一点。

下面的代码示例演示如何勾选标签对齐:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.docx");
Shape shape = (Shape) doc.getChild(NodeType.SHAPE, 0, true);
ChartAxis axis = shape.getChart().getAxisX();

//This property has effect only for multi-line labels.
axis.setTickLabelAlignment(ParagraphAlignment.RIGHT);

doc.save(dataDir + "Document_out.docx");

Microsoft Word默认情况下将图表标签对齐到中心。

如何设置填充和笔画格式

可以为图表系列、数据点和标记设置填充和笔画格式。 为此，您需要在ChartSeries，ChartDataPoint和ChartMarker类中使用ChartFormat类型的属性，以及某些属性的别名，例如ForeColor，BackColor，可见和Stroke类中的透明度。

下面的代码示例演示如何设置系列颜色:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;

// Delete default generated series.
seriesColl.Clear();

// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });

// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;

doc.Save("ColumnColor.docx");

下面的代码示例演示如何设置线条颜色和权重:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);

Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;

// Delete default generated series.
seriesColl.Clear();

// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });

// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;

doc.Save("LineColorAndWeight.docx");