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

> 了解如何使用 Aspose.Slides for Python 对 PowerPoint 和 OpenDocument 幻灯片进行形状的分组和取消分组——快速、分步指南，并提供免费代码。

Source: https://docs.aspose.com/slides/zh/python-net/group/
Updated: 2025-12-08


## **概述**

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

## **添加分组形状**

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

1. 创建 [Presentation](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) 类的实例。
2. 按索引获取幻灯片的引用。
3. 向幻灯片添加一个 [GroupShape](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/)。
4. 向新建的分组形状中添加形状。
5. 将修改后的演示文稿保存为 PPTX 文件。

下面的示例演示了如何向幻灯片添加分组形状。
```py
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](https://reference.aspose.com/slides/python-net/aspose.slides/presentation/) 类以表示 PPTX 文件。
2. 按索引获取幻灯片的引用。
3. 访问幻灯片的 shapes 集合。
4. 访问 [GroupShape](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/)。
5. 读取 Alt Text 属性。

下面的示例检索了分组形状中包含的形状的 Alt Text。
```py
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](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/) 具有 [parent_group](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/parent_group/) 属性，直接表明支持层级关系（一个组可以是另一个组的子组）。

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

使用 [GroupShape](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/) 的 [z_order_position](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/z_order_position/) 属性检查其在显示堆栈中的位置。

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

可以。组的锁定部分通过 [group_shape_lock](https://reference.aspose.com/slides/python-net/aspose.slides/groupshape/group_shape_lock/) 暴露，您可以限制对该对象的操作。