使用 Python 在演示文稿中格式化图表

概述

本指南展示了如何使用 Aspose.Slides for Python 对 PowerPoint 图表进行格式化。它逐步说明了对核心图表实体（如类别轴和值轴、网格线、标签、标题、图例以及次坐标轴）的自定义，并演示如何通过简洁可运行的代码示例来控制字体、数字格式、填充、轮廓、绘图区域和背壁颜色以及圆角图表。遵循这些步骤示例，您将创建一个 Presentation，添加并配置图表，并将结果保存为 PPTX，同时应用精确的视觉和排版设置。

格式化图表元素

Aspose.Slides for Python 允许开发者从头添加自定义图表到幻灯片。本节说明如何格式化各种图表元素，包括类别轴和值轴。

Aspose.Slides 提供了一个简单的 API 用于管理图表元素并应用自定义格式：

  1. 创建一个 Presentation 类的实例。
  2. 通过索引获取幻灯片的引用。
  3. 添加一个默认数据的图表，类型为所需类型（在本例中为 ChartType.LINE_WITH_MARKERS）。
  4. 访问图表的值轴并设置以下内容：
    1. 为值轴主网格线设置 线条格式。
    2. 为值轴次网格线设置 线条格式。
    3. 为值轴设置 数字格式。
    4. 为值轴设置 最小值、最大值、主单位和次单位。
    5. 为值轴标签设置 文本属性。
    6. 为值轴设置 标题。
    7. 为值轴设置 线条格式。
  5. 访问图表的类别轴并设置以下内容：
    1. 为类别轴主网格线设置 线条格式。
    2. 为类别轴次网格线设置 线条格式。
    3. 为类别轴标签设置 文本属性。
    4. 为类别轴设置 标题。
    5. 为类别轴设置 标签定位。
    6. 为类别轴标签设置 旋转角度。
  6. 访问图表图例并设置其 文本属性。
  7. 显示图表图例且不与图表重叠。
  8. 访问图表的 次值轴 并设置以下内容：
    1. 启用次 值轴。
    2. 为次值轴设置 线条格式。
    3. 为次值轴设置 数字格式。
    4. 为次值轴设置 最小值、最大值、主单位和次单位。
  9. 将第一个图表系列绘制在次值轴上。
  10. 设置图表背壁的填充颜色。
  11. 设置图表绘图区的填充颜色。
  12. 将修改后的演示文稿写入 PPTX 文件。
import aspose.slides.charts as charts
import aspose.slides as slides
import aspose.pydrawing as draw

# 实例化 Presentation 类。
with slides.Presentation() as presentation:

    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    # 添加示例图表。
    chart = slide.shapes.add_chart(charts.ChartType.LINE_WITH_MARKERS, 50, 50, 500, 400)

    # 设置图表标题。
    chart.has_title = True
    chart.chart_title.add_text_frame_for_overriding("")
    chart_title = chart.chart_title.text_frame_for_overriding.paragraphs[0].portions[0]
    chart_title.text = "Sample Chart"
    chart_title.portion_format.fill_format.fill_type = slides.FillType.SOLID
    chart_title.portion_format.fill_format.solid_fill_color.color = draw.Color.gray
    chart_title.portion_format.font_height = 20
    chart_title.portion_format.font_bold = 1
    chart_title.portion_format.font_italic = 1

    # 为数值轴设置主网格线格式。
    chart.axes.vertical_axis.major_grid_lines_format.line.fill_format.fill_type = slides.FillType.SOLID
    chart.axes.vertical_axis.major_grid_lines_format.line.fill_format.solid_fill_color.color = draw.Color.blue
    chart.axes.vertical_axis.major_grid_lines_format.line.width = 5
    chart.axes.vertical_axis.major_grid_lines_format.line.dash_style = slides.LineDashStyle.DASH_DOT

    # 为数值轴设置次网格线格式。
    chart.axes.vertical_axis.minor_grid_lines_format.line.fill_format.fill_type = slides.FillType.SOLID
    chart.axes.vertical_axis.minor_grid_lines_format.line.fill_format.solid_fill_color.color = draw.Color.red
    chart.axes.vertical_axis.minor_grid_lines_format.line.width = 3

    # 设置数值轴的数字格式。
    chart.axes.vertical_axis.is_number_format_linked_to_source = False
    chart.axes.vertical_axis.display_unit = charts.DisplayUnitType.THOUSANDS
    chart.axes.vertical_axis.number_format = "0.0%"

    # 设置数值轴的最大值、最小值、主单位和次单位。
    chart.axes.vertical_axis.is_automatic_major_unit = False
    chart.axes.vertical_axis.is_automatic_max_value = False
    chart.axes.vertical_axis.is_automatic_minor_unit = False
    chart.axes.vertical_axis.is_automatic_min_value = False

    chart.axes.vertical_axis.max_value = 15
    chart.axes.vertical_axis.min_value = -2
    chart.axes.vertical_axis.minor_unit = 0.5
    chart.axes.vertical_axis.major_unit = 2.0

    # 设置数值轴文本属性。
    vertical_axis_portion_format = chart.axes.vertical_axis.text_format.portion_format
    vertical_axis_portion_format.font_bold = 1
    vertical_axis_portion_format.font_height = 16
    vertical_axis_portion_format.font_italic = 1
    vertical_axis_portion_format.fill_format.fill_type = slides.FillType.SOLID 
    vertical_axis_portion_format.fill_format.solid_fill_color.color = draw.Color.dark_green
    vertical_axis_portion_format.latin_font = slides.FontData("Times New Roman")

    # 设置数值轴标题。
    chart.axes.vertical_axis.has_title = True
    chart.axes.vertical_axis.title.add_text_frame_for_overriding("")
    vertical_axis_title = chart.axes.vertical_axis.title.text_frame_for_overriding.paragraphs[0].portions[0]
    vertical_axis_title.text = "Primary Axis"
    vertical_axis_title.portion_format.fill_format.fill_type = slides.FillType.SOLID
    vertical_axis_title.portion_format.fill_format.solid_fill_color.color = draw.Color.gray
    vertical_axis_title.portion_format.font_height = 20
    vertical_axis_title.portion_format.font_bold = 1
    vertical_axis_title.portion_format.font_italic = 1

    # 为类别轴设置主网格线格式。
    chart.axes.horizontal_axis.major_grid_lines_format.line.fill_format.fill_type = slides.FillType.SOLID
    chart.axes.horizontal_axis.major_grid_lines_format.line.fill_format.solid_fill_color.color = draw.Color.green
    chart.axes.horizontal_axis.major_grid_lines_format.line.width = 5

    # 为类别轴设置次网格线格式。
    chart.axes.horizontal_axis.minor_grid_lines_format.line.fill_format.fill_type = slides.FillType.SOLID
    chart.axes.horizontal_axis.minor_grid_lines_format.line.fill_format.solid_fill_color.color = draw.Color.yellow
    chart.axes.horizontal_axis.minor_grid_lines_format.line.width = 3

    # 设置类别轴文本属性。
    horizontal_axis_portion_format = chart.axes.horizontal_axis.text_format.portion_format
    horizontal_axis_portion_format.font_bold = 1
    horizontal_axis_portion_format.font_height = 16
    horizontal_axis_portion_format.font_italic = 1
    horizontal_axis_portion_format.fill_format.fill_type = slides.FillType.SOLID 
    horizontal_axis_portion_format.fill_format.solid_fill_color.color = draw.Color.blue
    horizontal_axis_portion_format.latin_font = slides.FontData("Arial")

    # 设置类别轴标题。
    chart.axes.horizontal_axis.has_title = True
    chart.axes.horizontal_axis.title.add_text_frame_for_overriding("")

    horizontal_axis_title = chart.axes.horizontal_axis.title.text_frame_for_overriding.paragraphs[0].portions[0]
    horizontal_axis_title.text = "Sample Category"
    horizontal_axis_title.portion_format.fill_format.fill_type = slides.FillType.SOLID
    horizontal_axis_title.portion_format.fill_format.solid_fill_color.color = draw.Color.gray
    horizontal_axis_title.portion_format.font_height = 20
    horizontal_axis_title.portion_format.font_bold = 1
    horizontal_axis_title.portion_format.font_italic = 1

    # 设置类别轴标签位置。
    chart.axes.horizontal_axis.tick_label_position = charts.TickLabelPositionType.LOW

    # 设置类别轴标签旋转角度。
    chart.axes.horizontal_axis.tick_label_rotation_angle = 45

    # 设置图例文本属性。
    legend_portion_format = chart.legend.text_format.portion_format
    legend_portion_format.font_bold = 1
    legend_portion_format.font_height = 16
    legend_portion_format.font_italic = 1
    legend_portion_format.fill_format.fill_type = slides.FillType.SOLID 
    legend_portion_format.fill_format.solid_fill_color.color = draw.Color.dark_red

    # 显示图例覆盖在图表上。
    chart.legend.overlay = True
                
    # 设置图表背墙颜色。
    chart.back_wall.thickness = 1
    chart.back_wall.format.fill.fill_type = slides.FillType.SOLID
    chart.back_wall.format.fill.solid_fill_color.color = draw.Color.orange

    chart.floor.format.fill.fill_type = slides.FillType.SOLID
    chart.floor.format.fill.solid_fill_color.color = draw.Color.red

    # 设置绘图区域颜色。
    chart.plot_area.format.fill.fill_type = slides.FillType.SOLID
    chart.plot_area.format.fill.solid_fill_color.color = draw.Color.light_cyan

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

设置图表字体属性

Aspose.Slides for Python 支持为图表设置与字体相关的属性。请按照以下步骤配置图表字体属性：

  1. 实例化一个 Presentation 对象。
  2. 向幻灯片添加图表。
  3. 设置字体高度。
  4. 保存修改后的演示文稿。

下面提供示例代码。

import aspose.slides.charts as charts
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 100, 100, 500, 400)
    chart.text_format.portion_format.font_height = 20
    chart.chart_data.series[0].labels.default_data_label_format.show_value = True

    presentation.save("ChartFontProperties.pptx", slides.export.SaveFormat.PPTX)

设置数字格式

Aspose.Slides for Python 为管理图表数据格式提供了简单的 API：

  1. 创建一个 Presentation 类的实例。
  2. 通过索引获取幻灯片的引用。
  3. 添加一个默认数据的图表，类型为所需类型。
  4. 从可用的预设值中设置预设数字格式。
  5. 遍历每个系列的图表数据单元格并设置数字格式。
  6. 保存演示文稿。
  7. 设置自定义数字格式。
  8. 再次遍历每个系列的图表数据单元格并设置不同的数字格式。
  9. 保存演示文稿。
import aspose.slides.charts as charts
import aspose.slides as slides

# 实例化 Presentation 类。
with slides.Presentation() as presentation:
    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    # 添加默认的簇状柱形图。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 500, 400)

    # 设置预设数字格式。
    # 遍历每个图表系列。
    for series in chart.chart_data.series:
        # 遍历系列中的每个数据点。
        for cell in series.data_points:
            # 设置数字格式。
            cell.value.as_cell.preset_number_format = 10  # 0.00%

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

以下列出了可用的预设数字格式及其对应的索引。

0 General
1 0
2 0.00
3 #,##0
4 #,##0.00
5 $#,##0;$-#,##0
6 $#,##0;Red$-#,##0
7 $#,##0.00;$-#,##0.00
8 $#,##0.00;Red$-#,##0.00
9 0%
10 0.00%
11 0.00E+00
12 # ?/?
13 # /
14 m/d/yy
15 d-mmm-yy
16 d-mmm
17 mmm-yy
18 h:mm AM/PM
19 h:mm:ss AM/PM
20 h:mm
21 h:mm:ss
22 m/d/yy h:mm
37 #,##0;-#,##0
38 #,##0;Red-#,##0
39 #,##0.00;-#,##0.00
40 #,##0.00;Red-#,##0.00
41 _ * #,##0_ ;_ * “_ ;_ @_
42 _ $* #,##0_ ;_ $* “_ ;_ @_
43 _ * #,##0.00_ ;_ * “??_ ;_ @_
44 _ $* #,##0.00_ ;_ $* “??_ ;_ @_
45 mm:ss
46 h:mm:ss
47 mm:ss.0
48 ##0.0E+00
49 @

为图表区域设置圆角边框

Aspose.Slides for Python 支持使用 Chart.has_rounded_corners 属性配置图表区域：

  1. 实例化一个 Presentation 对象。
  2. 向幻灯片添加图表。
  3. 设置图表的填充类型和填充颜色。
  4. 将圆角属性设置为 True。
  5. 保存修改后的演示文稿。

下面提供示例。

import aspose.slides.charts as charts
import aspose.slides as slides

with slides.Presentation() as presentation:
	slide = presentation.slides[0]

	chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 100, 600, 400)
	chart.line_format.fill_format.fill_type = slides.FillType.SOLID
	chart.line_format.style = slides.LineStyle.SINGLE
	chart.has_rounded_corners = True

	presentation.save("RoundedBorders.pptx", slides.export.SaveFormat.PPTX)

常见问题

我可以为柱形/区域设置半透明填充，同时保持边框不透明吗？

是的。填充透明度和轮廓是分开配置的。这对于在密集的可视化中提高网格和数据的可读性非常有用。

当数据标签重叠时，我该如何处理？

可以减少字体大小，禁用非必要的标签组件（例如类别），设置标签的偏移/位置，必要时仅为选定的点显示标签，或将格式切换为“数值 + 图例”。

我可以对系列应用渐变或图案填充吗？

可以。通常同时提供纯色和渐变/图案填充。实际使用时请适度使用渐变，并避免与网格和文本形成对比度降低的组合。

优化 Python 演示文稿中的图表计算 使用 Python 在演示文稿中管理图表工作簿