.NET 中演示文稿图表的误差线自定义

添加误差线

Aspose.Slides for .NET 提供了一个简洁的 API 来管理误差线数值。示例代码适用于使用自定义值类型的情况。要指定数值，请使用系列的 DataPoints 集合中特定数据点的 ErrorBarCustomValues 属性：

创建 Presentation 类的实例。
在所需幻灯片上添加气泡图。
访问第一个图表系列并设置误差线 X 轴格式。
访问第一个图表系列并设置误差线 Y 轴格式。
设置误差线的数值和格式。
将修改后的演示文稿写入 PPTX 文件。

// 创建空白演示文稿
using (Presentation presentation = new Presentation())
{
    // 创建气泡图表
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // 添加误差线并设置其格式
    IErrorBarsFormat errBarX = chart.ChartData.Series[0].ErrorBarsXFormat;
    IErrorBarsFormat errBarY = chart.ChartData.Series[0].ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Fixed;
    errBarX.Value = 0.1f;
    errBarY.ValueType = ErrorBarValueType.Percentage;
    errBarY.Value = 5;
    errBarX.Type = ErrorBarType.Plus;
    errBarY.Format.Line.Width = 2;
    errBarX.HasEndCap = true;

    // 保存演示文稿
    presentation.Save("ErrorBars_out.pptx", SaveFormat.Pptx);
}

添加自定义误差线值

Aspose.Slides for .NET 提供了一个简洁的 API 来管理自定义误差线数值。示例代码适用于 IErrorBarsFormat.ValueType 属性等于 Custom 的情况。要指定数值，请使用系列的 DataPoints 集合中特定数据点的 ErrorBarCustomValues 属性：

创建 Presentation 类的实例。
在所需幻灯片上添加气泡图。
访问第一个图表系列并设置误差线 X 轴格式。
访问第一个图表系列并设置误差线 Y 轴格式。
访问图表系列的单个数据点并为各数据点设置误差线数值。
设置误差线的数值和格式。
将修改后的演示文稿写入 PPTX 文件。

// 创建空白演示文稿
using (Presentation presentation = new Presentation())
{
    // 创建气泡图表
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // 添加自定义误差线并设置其格式
    IChartSeries series = chart.ChartData.Series[0];
    IErrorBarsFormat errBarX = series.ErrorBarsXFormat;
    IErrorBarsFormat errBarY = series.ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Custom;
    errBarY.ValueType = ErrorBarValueType.Custom;

    // 访问图表系列数据点并为单个点设置误差线值
    IChartDataPointCollection points = series.DataPoints;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXMinusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYMinusValues = DataSourceType.DoubleLiterals;

    // 为图表系列点设置误差线
    for (int i = 0; i < points.Count; i++)
    {
        points[i].ErrorBarsCustomValues.XMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.XPlus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YPlus.AsLiteralDouble = i + 1;
    }

    // 保存演示文稿
    presentation.Save("ErrorBarsCustomValues_out.pptx", SaveFormat.Pptx);
}

FAQ

将演示文稿导出为 PDF 或图像时，误差线会怎样？

它们作为图表的一部分进行渲染，并在转换过程中与其余图表格式一起保留，前提是使用兼容的版本或渲染器。

误差线可以与标记和数据标签一起使用吗？

可以。误差线是独立的元素，且可以与标记和数据标签兼容；如果元素重叠，可能需要调整格式。

在哪里可以找到 API 中用于处理误差线的属性和枚举列表？

在 API 参考中：ErrorBarsFormat 类以及相关枚举 ErrorBarType 和 ErrorBarValueType。