使用 Python 自定义演示文稿图表中的误差线

添加误差线

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

  1. 创建 Presentation 类的实例。
  2. 在所需幻灯片上添加气泡图。
  3. 访问第一个图表系列并设置误差线 X 格式。
  4. 访问第一个图表系列并设置误差线 Y 格式。
  5. 设置误差线的值和格式。
  6. 将修改后的演示文稿写入 PPTX 文件。
import aspose.slides.charts as charts
import aspose.slides as slides

# 创建空白演示文稿
with slides.Presentation() as presentation:
    # 创建气泡图表
    chart = presentation.slides[0].shapes.add_chart(charts.ChartType.BUBBLE, 50, 50, 400, 300, True)

    # 添加误差线并设置其格式
    errBarX = chart.chart_data.series[0].error_bars_x_format
    errBarY = chart.chart_data.series[0].error_bars_y_format
    errBarX.is_visible = True
    errBarY.is_visible = True
    errBarX.value_type = charts.ErrorBarValueType.FIXED
    errBarX.value = 0.1
    errBarY.value_type = charts.ErrorBarValueType.PERCENTAGE
    errBarY.value = 5
    errBarX.type = charts.ErrorBarType.PLUS
    errBarY.format.line.width = 2
    errBarX.has_end_cap = True

    # 保存演示文稿
    presentation.save("ErrorBars_out.pptx", slides.export.SaveFormat.PPTX)

添加自定义误差线值

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

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

# 创建空白演示文稿
with slides.Presentation() as presentation:
    # 创建气泡图表
    chart = presentation.slides[0].shapes.add_chart(charts.ChartType.BUBBLE, 50, 50, 400, 300, True)

    # 添加自定义误差线并设置其格式
    series = chart.chart_data.series[0]
    errBarX = series.error_bars_x_format
    errBarY = series.error_bars_y_format
    errBarX.is_visible = True
    errBarY.is_visible = True
    errBarX.value_type = charts.ErrorBarValueType.CUSTOM
    errBarY.value_type = charts.ErrorBarValueType.CUSTOM

    # 访问图表系列数据点并为单个点设置误差线值
    points = series.data_points
    points.data_source_type_for_error_bars_custom_values.data_source_type_for_x_plus_values = charts.DataSourceType.DOUBLE_LITERALS
    points.data_source_type_for_error_bars_custom_values.data_source_type_for_x_minus_values = charts.DataSourceType.DOUBLE_LITERALS
    points.data_source_type_for_error_bars_custom_values.data_source_type_for_y_plus_values = charts.DataSourceType.DOUBLE_LITERALS
    points.data_source_type_for_error_bars_custom_values.data_source_type_for_y_minus_values = charts.DataSourceType.DOUBLE_LITERALS

    # 为图表系列点设置误差线
    for i in range(len(points)):
        points[i].error_bars_custom_values.x_minus.as_literal_double = i + 1
        points[i].error_bars_custom_values.x_plus.as_literal_double = i + 1
        points[i].error_bars_custom_values.y_minus.as_literal_double = i + 1
        points[i].error_bars_custom_values.y_plus.as_literal_double = i + 1

    # 保存演示文稿
    presentation.save("ErrorBarsCustomValues_out.pptx", slides.export.SaveFormat.PPTX)

常见问题

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

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

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

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

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

请参考 API 文档：ErrorBarsFormat 类以及相关枚举 ErrorBarType 和 ErrorBarValueType。