在 Android 上为演示文稿图表添加趋势线

本页内容简介

使用 Aspose.Slides for Android（通过 Java），快速在 PowerPoint 图表中添加和自定义趋势线——实用指南，帮助您吸引观众。

概述

本文介绍如何使用 Aspose.Slides 向演示文稿图表添加趋势线。它展示了如何创建图表、向图表系列添加趋势线，以及使用多种趋势线类型，包括指数、线性、对数、移动平均、多项式和幂。

它还描述了如何通过插入线形状向图表添加自定义线，并包含一个简短的 FAQ，说明趋势线的前向和后向投影值的含义，以及在导出为 PDF 或 SVG 或将图表渲染为图像时趋势线是否会被保留。

添加趋势线

使用ITrendlineCollection.add向图表系列添加趋势线，并通过TrendlineType选择其类型。示例创建了一个带默认数据的聚集柱形图，并向其三个系列中的每个系列添加了两条趋势线。

指数趋势线通过setDisplayEquation和setDisplayRSquaredValue隐藏其公式和 R 平方值，而线性趋势线为红色。对数趋势线使用addTextFrameForOverriding添加自定义标签。移动平均使用setPeriod设置为三个数据点，并使用自定义setTrendlineName。

多项式趋势线的setOrder为 3，并通过setForward向前延伸一个类别。幂趋势线通过setBackward向后延伸一个类别。

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 400);

    IChartSeries firstSeries = chart.getChartData().getSeries().get_Item(0);

    ITrendline exponentialTrendline = firstSeries.getTrendLines().add(TrendlineType.Exponential);
    exponentialTrendline.setDisplayEquation(false);
    exponentialTrendline.setDisplayRSquaredValue(false);

    ITrendline linearTrendline = firstSeries.getTrendLines().add(TrendlineType.Linear);
    linearTrendline.getFormat().getLine().getFillFormat().setFillType(FillType.Solid);
    linearTrendline.getFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.RED);

    IChartSeries secondSeries = chart.getChartData().getSeries().get_Item(1);

    ITrendline logarithmicTrendline = secondSeries.getTrendLines().add(TrendlineType.Logarithmic);
    logarithmicTrendline.addTextFrameForOverriding("New log trend line");

    ITrendline movingAverageTrendline = secondSeries.getTrendLines().add(TrendlineType.MovingAverage);
    movingAverageTrendline.setPeriod((byte) 3);
    movingAverageTrendline.setTrendlineName("New TrendLine Name");

    IChartSeries thirdSeries = chart.getChartData().getSeries().get_Item(2);

    ITrendline polynomialTrendline = thirdSeries.getTrendLines().add(TrendlineType.Polynomial);
    polynomialTrendline.setForward(1);
    polynomialTrendline.setOrder((byte) 3);

    ITrendline powerTrendline = thirdSeries.getTrendLines().add(TrendlineType.Power);
    powerTrendline.setBackward(1);

    presentation.save("ChartTrendLines.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

设置趋势线截距

使用setIntercept将趋势线的 Y 值固定在 X = 0。此设置支持线性、指数和多项式趋势线。

例如，生产成本模型可能需要从已知的固定成本 100 开始，即使在非零产量的测量值表明不同的基准。对于线性趋势线，将截距固定为 100 将方程 y = ax + b 约束为 b = 100；斜率在此约束下拟合数据。这并不是简单地移动已拟合的直线。坐标轴交叉设置控制图表坐标轴的相交位置，而不是已拟合趋势线的系数。

以下示例创建一个散点 (XY) 图表，产量从 1 到 4，成本分别为 170、200、230 和 260。它先以默认自动截距保存图表，然后将截距设为 100，再保存第二个 PPTX。这两个文件仅在截距设置上不同。趋势线显示其公式并延伸回 X = 0。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ScatterWithMarkers, 20, 20, 480, 210);
    chart.setLegend(false);

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    workbook.clear(0);

    IChartDataCell nameCell = workbook.getCell(0, 0, 1, "Production cost");
    IChartSeries series = chart.getChartData().getSeries().add(nameCell, ChartType.ScatterWithMarkers);
    double[] costs = { 170, 200, 230, 260 };

    for (int i = 0; i < costs.length; i++) {
        IChartDataCell xCell = workbook.getCell(0, i + 1, 0, i + 1);
        IChartDataCell yCell = workbook.getCell(0, i + 1, 1, costs[i]);
        series.getDataPoints().addDataPointForScatterSeries(xCell, yCell);
    }

    ITrendline trendline = series.getTrendLines().add(TrendlineType.Linear);
    trendline.setDisplayEquation(true);
    trendline.setBackward(1);

    presentation.save("AutomaticIntercept.pptx", SaveFormat.Pptx);

    trendline.setIntercept(100);
    presentation.save("FixedIntercept.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

使用自动计算时，这些数据产生 y = 30x + 140。将截距设为 100 则大约得到 y = 43.33x + 100：零点的拟合值匹配已知基准，而该直线不再通过所有数据点。

自动截距	截距固定为 100

两幅图使用相同的数据和坐标轴比例。趋势线向后延伸到 X = 0 以显示其截距。

默认情况下，getIntercept 返回 Double.NaN，表示未指定的截距而非零。随后截距会根据数据自动计算。

添加自定义线

自定义线是一种绘制在图表之上的形状，而不是由系列数据计算的趋势线。此示例使用IShapeCollection.addAutoShape在幻灯片的图表上方添加一条水平线。该线的位置以幻灯片坐标（点）指定，因此从图表左边缘开始，位于图表高度的中间。其宽度与图表宽度相同。getLineFormat 为该线设置实体红色。

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 500, 400);

    IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, chart.getX(), chart.getY() + chart.getHeight() / 2, chart.getWidth(), 0);
    line.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    line.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);

    presentation.save("AddCustomLines.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

趋势线的“前向”和“后向”是什么意思？

它们是趋势线向前/向后投射的长度：对于散点 (XY) 图表，以坐标轴单位计量；对于非散点图表，以类别数量计量。仅允许非负值。

将演示文稿导出为 PDF 或 SVG，或将幻灯片渲染为图像时，趋势线会被保留吗？

是的。Aspose.Slides 可将演示文稿转换为PDF或SVG，并将图表渲染为图像；趋势线作为图表的一部分，在这些操作中会被保留。还提供了一个方法，可导出图表的图像。