使用 Python 管理演示文稿中的 SmartArt 图形

概述

Aspose.Slides 允许您以编程方式在 PowerPoint 演示文稿中创建和管理 SmartArt 图形。本文介绍如何向幻灯片添加 SmartArt 形状、访问现有 SmartArt 形状、通过特定布局类型查找 SmartArt，以及通过更改 SmartArt 样式或颜色样式来更新其视觉外观。

示例展示了如何通过演示文稿幻灯片的形状集合使用 SmartArt 形状，检查形状是否为 SmartArt，然后修改或检查其属性。

创建 SmartArt 形状

Aspose.Slides for Python via Java 提供了创建 SmartArt 形状的 API。要在幻灯片中创建 SmartArt 形状，请按照以下步骤操作：

  1. 创建 Presentation 类的实例。
  2. 通过索引获取幻灯片。
  3. 通过指定 SmartArtLayoutType 来 添加 SmartArt 形状。
  4. 将修改后的演示文稿保存为 PPTX 文件。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    # 获取第一张幻灯片。
    slide = presentation.getSlides().get_Item(0)

    # 添加 SmartArt 形状。
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList)

    # 保存演示文稿。
    presentation.save("SimpleSmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
图：已添加到幻灯片的 SmartArt 形状

访问幻灯片上的 SmartArt 形状

以下示例访问演示文稿幻灯片上的 SmartArt 形状。它遍历幻灯片上的每个形状，并检查该形状是否为 SmartArt 实例。

import jpase
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # 遍历第一张幻灯片上的每个形状。
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            print("Shape Name: " + str(smart_art.getName()))
finally:
    presentation.dispose()

使用特定布局类型访问 SmartArt 形状

以下示例访问具有特定布局类型的 SmartArt 形状，该布局类型由 SmartArt.getLayout 返回。

  1. 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
  2. 通过索引获取第一张幻灯片。
  3. 遍历第一张幻灯片上的每个形状。
  4. 检查该形状是否为 SmartArt 实例。
  5. 检查 SmartArt 形状是否具有指定的布局类型并执行所需操作。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt, SmartArtLayoutType

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # 遍历第一张幻灯片上的每个形状。
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # 检查 SmartArt 布局。
            if smart_art.getLayout() == SmartArtLayoutType.BasicBlockList:
                print("Perform the required operation here.")
finally:
    presentation.dispose()

更改 SmartArt 形状样式

本示例展示如何更改 SmartArt 形状的快速样式。

  1. 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
  2. 通过索引获取第一张幻灯片。
  3. 遍历第一张幻灯片上的每个形状。
  4. 检查该形状是否为 SmartArt 实例。
  5. 找到具有指定样式的 SmartArt 形状。
  6. 为该 SmartArt 形状设置新的样式。
  7. 保存演示文稿。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtQuickStyleType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # 遍历第一张幻灯片上的每个形状。
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # 检查并更改 SmartArt 样式。
            if smart_art.getQuickStyle() == SmartArtQuickStyleType.SimpleFill:
                smart_art.setQuickStyle(SmartArtQuickStyleType.Cartoon)

    presentation.save("ChangeSmartArtStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
图：已更改样式的 SmartArt 形状

更改 SmartArt 形状颜色样式

本示例访问具有特定颜色样式的 SmartArt 形状并更改该样式。

  1. 创建 Presentation 类的实例并加载包含 SmartArt 形状的演示文稿。
  2. 通过索引获取第一张幻灯片。
  3. 遍历第一张幻灯片上的每个形状。
  4. 检查该形状是否为 SmartArt 实例。
  5. 找到具有指定颜色样式的 SmartArt 形状。
  6. 为该 SmartArt 形状设置新的颜色样式。
  7. 保存演示文稿。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtColorType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # 遍历第一张幻灯片上的每个形状。
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # 检查并更改 SmartArt 样式。
            if smart_art.getColorStyle() == SmartArtColorType.ColoredFillAccent1:
                smart_art.setColorStyle(SmartArtColorType.ColorfulAccentColors)

    presentation.save("ChangeSmartArtColorStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
SmartArt shape
图：已更改颜色样式的 SmartArt 形状

FAQ

我可以将 SmartArt 作为单个对象进行动画处理吗？

是的。SmartArt 是一种形状，您可以通过动画 API（进入、退出、强调、运动路径）像对待其他形状一样应用 标准动画。

如果不知道 SmartArt 的内部 ID，如何在幻灯片上找到特定的 SmartArt？

设置并使用 替代文本 ，然后按该值搜索形状——这是定位目标形状的推荐方式。

我可以将 SmartArt 与其他形状组合在一起吗？

可以。您可以将 SmartArt 与其他形状（图片、表格等）组合，然后 操作该组。

如何获取特定 SmartArt 的图像（例如用于预览或报告）？

导出该形状的缩略图/图像；库可以 渲染单个形状 为光栅文件（PNG/JPG/TIFF）。

将整个演示文稿转换为 PDF 时，SmartArt 的外观会被保留吗？

会的。渲染引擎针对 PDF 导出 目标实现高保真度，并提供多种质量和兼容性选项。

在 PowerPoint 演示文稿中使用 Python 管理 SmartArt 使用 Python 管理演示文稿中的 SmartArt 形状节点