使用 Python 对演示文稿形状进行分组

概述

将形状分组后，可将多个绘图对象视为一个单元，从而一起移动、调整大小、格式化和变换。使用 Aspose.Slides for Python，您可以创建一个 GroupShape，在其中添加和排列子形状，并将结果保存为 PPTX。本文演示了如何在幻灯片上添加分组形状，以及如何从组内形状访问可访问性元数据（例如 Alt Text），从而实现更清晰的结构和更丰富、易于维护的演示文稿。

添加分组形状

Aspose.Slides 支持在幻灯片上使用分组形状。该功能让您通过将多个形状视为单个对象来构建更丰富的演示文稿。您可以添加新的分组形状，访问已有的分组形状，为其填充子形状，并读取或修改它们的任意属性。向幻灯片添加分组形状的步骤：

1. 创建 Presentation 类的实例。
2. 按索引获取幻灯片的引用。
3. 向幻灯片添加一个 GroupShape。
4. 向新建的分组形状中添加形状。
5. 将修改后的演示文稿保存为 PPTX 文件。

下面的示例演示了如何向幻灯片添加分组形状。

import aspose.slides as slides

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

    # 向幻灯片添加组形状。
    group_shape = slide.shapes.add_group_shape()

    # 在组形状内添加形状。
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 300, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 300, 100, 100)

    # 将 PPTX 文件写入磁盘。
    presentation.save("group_shape.pptx", slides.export.SaveFormat.PPTX)

访问 Alt Text 属性

本节说明如何使用 Aspose.Slides 读取幻灯片上分组形状中包含的形状的 Alt Text。访问 Alt Text 的步骤：

1. 实例化 Presentation 类以表示 PPTX 文件。
2. 按索引获取幻灯片的引用。
3. 访问幻灯片的 shapes 集合。
4. 访问 GroupShape。
5. 读取 Alt Text 属性。

下面的示例检索了分组形状中包含的形状的 Alt Text。

import aspose.slides as slides

# 实例化 Presentation 类以打开 PPTX 文件。
with slides.Presentation("group_shape.pptx") as presentation:
    # 获取第一张幻灯片。
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.GroupShape):
            # 访问组形状。
            for child_shape in shape.shapes:
                # 访问 Alt Text 属性。
                print(child_shape.alternative_text)

常见问题

是否支持嵌套分组（组内包含组）？

是的。GroupShape 具有 parent_group 属性，直接表明支持层级关系（一个组可以是另一个组的子组）。

如何控制组相对于幻灯片上其他对象的 Z 顺序？

使用 GroupShape 的 z_order_position 属性检查其在显示堆栈中的位置。

我可以阻止移动/编辑/取消分组吗？

可以。组的锁定部分通过 group_shape_lock 暴露，您可以限制对该对象的操作。