【python-pptx】一文详解幻灯片中shape形状

Understanding Shapes

幻灯片上的几乎所有内容都是形状；我能想到的可以在幻灯片上出现但不是形状的唯一东西是幻灯片背景。根据您的计算方式，有六到十种不同类型的形状。我将解释一些您需要理解的一般形状概念，以便理解如何与它们一起工作，然后我们将直接开始处理特定类型。

从技术上讲，可以放置在幻灯片上的形状有六种且只有六种不同类型：

六种技术形状类型

auto shape（自动形状）

这是一个常规形状，如矩形、椭圆或块箭头。它们有大量预设形状，大约有180种不同的形状。自动形状可以有填充和轮廓，并且可以包含文本。一些自动形状有调整点，那些小的黄色菱形，您可以拖动它们来调整圆角矩形的圆角程度。文本框也是一个自动形状，一个矩形，默认情况下没有填充和轮廓。

picture（图片）

光栅图像，如照片或剪贴画，在PowerPoint中被称为_图片_。它是自己的一种形状，与自动形状有不同的行为。请注意，自动形状可以有图片填充，其中图像作为形状的背景"显示出来"，而不是填充颜色或渐变。这是不同的东西。但很酷。

graphic frame（图形框架）

这是容纳表格、图表、智能艺术图表或媒体剪辑的容器的技术名称。您不能单独添加其中一个，它只是在您添加图形对象时出现在文件中。您可能不需要对这些了解更多。

group shape（组合形状）

在PowerPoint中，一组形状可以被_组合_，允许它们作为一个单元被选择、移动、调整大小，甚至填充。当您组合一组形状时，会创建一个组合形状来包含这些成员形状。您实际上看不到这些，除非在组合被选中时通过它们的边界框。

line/connector（线条/连接器）

线条与自动形状不同，因为，嗯，它们是线性的。一些线条可以连接到其他形状，并在其他形状移动时保持连接。这些还不被支持，所以我对它们了解不多。我最好很快处理这些，它们看起来会非常有用。

content part（内容部分）

我实际上对这些只有最模糊的概念。它与在演示文稿中嵌入"外来"XML（如SVG）有关。我相当确定PowerPoint本身不会对这些做任何事情。我的策略是忽略它们。到目前为止效果很好。

实际生活中的形状类型

至于实际生活中的形状，有这九种类型：

• shape shapes – 有填充和轮廓的自动形状
• text boxes – 没有填充和轮廓的自动形状
• placeholders – 可以出现在幻灯片布局或母版上并在使用该布局的幻灯片上继承的自动形状，允许添加采用占位符格式的内容
• line/connector – 如上所述
• picture – 如上所述
• table – 那个行和列的东西
• chart – 饼图、折线图等
• smart art – 还不被支持，但如果存在会被保留
• media clip – 视频或音频

访问幻灯片上的形状

每张幻灯片都有一个_形状树_来保存其形状。它被称为树是因为在一般情况下它是分层的；形状树中的节点可以是一个组合形状，它本身可以包含形状并具有与形状树相同的语义。对于大多数目的，形状树具有列表语义。您可以这样访问它：

shapes = slide.shapes

我们将在接下来的几个部分中看到更多关于形状树的内容。

形状层次结构

形状树的一个重要概念是它的层次结构：

• 根级别：直接属于幻灯片的形状
• 组合级别：组合形状内的形状
• 嵌套级别：更深层次的组合

这种层次结构允许复杂的形状组织和管理。

形状属性

所有形状都有一些共同的基本属性：

• 位置：形状在幻灯片上的位置（left, top）
• 大小：形状的宽度和高度（width, height）
• 可见性：形状是否可见
• 名称：形状的标识符

形状操作

常见的形状操作包括：

• 添加形状：在幻灯片上创建新形状
• 选择形状：通过索引或名称选择形状
• 移动形状：改变形状的位置
• 调整大小：改变形状的尺寸
• 删除形状：从幻灯片中移除形状

总结

本文档介绍了python-pptx中形状的基本概念：

1. 六种技术形状类型：auto shape、picture、graphic frame、group shape、line/connector、content part
2. 九种实际形状类型：包括文本框、占位符、表格、图表等
3. 形状树概念：形状的层次结构组织方式
4. 形状访问：通过slide.shapes访问幻灯片上的形状

这些是理解python-pptx中形状系统的基础，为后续处理各种类型的形状奠定了基础。

参考链接

• python-pptx官方文档
• python-pptx GitHub仓库
• python-pptx PyPI页面

示例脚本代码

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Understanding Shapes - python-pptx 示例脚本

本脚本演示了python-pptx中形状的基本概念，包括：
1. 六种技术形状类型
2. 九种实际形状类型
3. 形状树概念
4. 形状访问和基本操作

参考文档：https://python-pptx.readthedocs.io/en/latest/user/understanding-shapes.html
"""

import os
from pptx import Presentation
from pptx.enum.shapes import MSO_SHAPE_TYPE
from pptx.util import Inches


def demonstrate_shape_types():
    """示例1：演示形状类型概念"""
    print("=== 示例1：形状类型概念演示 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    print("六种技术形状类型：")
    print("1. auto shape - 自动形状（矩形、椭圆、箭头等）")
    print("2. picture - 图片（光栅图像）")
    print("3. graphic frame - 图形框架（表格、图表容器）")
    print("4. group shape - 组合形状（多个形状的组合）")
    print("5. line/connector - 线条/连接器")
    print("6. content part - 内容部分（外来XML）")
    
    print("\n九种实际形状类型：")
    print("1. shape shapes - 有填充和轮廓的自动形状")
    print("2. text boxes - 文本框（无填充和轮廓的自动形状）")
    print("3. placeholders - 占位符（继承格式的自动形状）")
    print("4. line/connector - 线条/连接器")
    print("5. picture - 图片")
    print("6. table - 表格")
    print("7. chart - 图表")
    print("8. smart art - 智能艺术（暂不支持）")
    print("9. media clip - 媒体剪辑")
    
    print()


def access_slide_shapes():
    """示例2：访问幻灯片上的形状"""
    print("=== 示例2：访问幻灯片形状 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    # 访问形状树
    shapes = slide.shapes
    print(f"✅ 成功访问形状树，当前形状数量：{len(shapes)}")
    
    # 显示形状树的基本信息
    print(f"形状树类型：{type(shapes)}")
    print(f"形状树是否支持列表操作：{hasattr(shapes, '__getitem__')}")
    print(f"形状树是否支持长度查询：{hasattr(shapes, '__len__')}")
    
    print("说明：新创建的空白幻灯片不包含任何形状")
    print()


def demonstrate_shape_hierarchy():
    """示例3：演示形状层次结构"""
    print("=== 示例3：形状层次结构演示 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    print("形状层次结构概念：")
    print("1. 根级别 - 直接属于幻灯片的形状")
    print("2. 组合级别 - 组合形状内的形状")
    print("3. 嵌套级别 - 更深层次的组合")
    
    # 添加一些基本形状来演示层次结构
    shapes = slide.shapes
    
    # 添加一个矩形（根级别）
    left = Inches(1)
    top = Inches(1)
    width = Inches(2)
    height = Inches(1)
    
    rectangle = shapes.add_shape(
        MSO_SHAPE_TYPE.RECTANGLE,
        left, top, width, height
    )
    
    print(f"\n✅ 添加了根级别形状：{rectangle.name}")
    print(f"形状类型：{rectangle.shape_type}")
    print(f"形状位置：({rectangle.left}, {rectangle.top})")
    print(f"形状大小：{rectangle.width} x {rectangle.height}")
    
    # 添加一个椭圆（根级别）
    left = Inches(4)
    top = Inches(1)
    
    ellipse = shapes.add_shape(
        MSO_SHAPE_TYPE.OVAL,
        left, top, width, height
    )
    
    print(f"✅ 添加了另一个根级别形状：{ellipse.name}")
    
    print(f"\n当前幻灯片上的形状数量：{len(shapes)}")
    print()


def demonstrate_shape_properties():
    """示例4：演示形状属性"""
    print("=== 示例4：形状属性演示 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    # 添加一个形状
    shapes = slide.shapes
    shape = shapes.add_shape(
        MSO_SHAPE_TYPE.ROUNDED_RECTANGLE,
        Inches(1), Inches(1), Inches(3), Inches(2)
    )
    
    print("形状的基本属性：")
    print(f"  名称：{shape.name}")
    print(f"  类型：{shape.shape_type}")
    print(f"  位置：({shape.left}, {shape.top})")
    print(f"  大小：{shape.width} x {shape.height}")
    print(f"  可见性：{shape.visible}")
    
    # 修改形状属性
    print("\n修改形状属性：")
    shape.left = Inches(2)
    shape.top = Inches(2)
    shape.width = Inches(4)
    shape.height = Inches(3)
    
    print(f"  新位置：({shape.left}, {shape.top})")
    print(f"  新大小：{shape.width} x {shape.height}")
    
    print()


def demonstrate_shape_operations():
    """示例5：演示形状操作"""
    print("=== 示例5：形状操作演示 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    shapes = slide.shapes
    
    # 添加多个形状
    shape1 = shapes.add_shape(
        MSO_SHAPE_TYPE.RECTANGLE,
        Inches(1), Inches(1), Inches(2), Inches(1)
    )
    shape1.name = "Rectangle1"
    
    shape2 = shapes.add_shape(
        MSO_SHAPE_TYPE.OVAL,
        Inches(4), Inches(1), Inches(2), Inches(1)
    )
    shape2.name = "Oval1"
    
    shape3 = shapes.add_shape(
        MSO_SHAPE_TYPE.TRIANGLE,
        Inches(1), Inches(3), Inches(2), Inches(1)
    )
    shape3.name = "Triangle1"
    
    print("添加了三个形状：")
    print(f"  1. {shape1.name} - {shape1.shape_type}")
    print(f"  2. {shape2.name} - {shape2.shape_type}")
    print(f"  3. {shape3.name} - {shape3.shape_type}")
    
    # 演示形状选择
    print(f"\n当前幻灯片上的形状数量：{len(shapes)}")
    print("通过索引访问形状：")
    for i in range(len(shapes)):
        shape = shapes[i]
        print(f"  形状 {i}: {shape.name} ({shape.shape_type})")
    
    # 演示形状遍历
    print("\n遍历所有形状：")
    for shape in shapes:
        print(f"  {shape.name}: 位置({shape.left}, {shape.top}), 大小({shape.width} x {shape.height})")
    
    print()


def create_comprehensive_shape_demo():
    """示例6：创建综合形状演示"""
    print("=== 示例6：综合形状演示 ===")
    
    # 创建演示文稿和幻灯片
    prs = Presentation()
    slide_layout = prs.slide_layouts[6]  # Blank layout
    slide = prs.slides.add_slide(slide_layout)
    
    shapes = slide.shapes
    
    # 添加不同类型的形状
    shape_configs = [
        (MSO_SHAPE_TYPE.RECTANGLE, "矩形", Inches(1), Inches(1), Inches(2), Inches(1)),
        (MSO_SHAPE_TYPE.OVAL, "椭圆", Inches(4), Inches(1), Inches(2), Inches(1)),
        (MSO_SHAPE_TYPE.TRIANGLE, "三角形", Inches(1), Inches(3), Inches(2), Inches(1)),
        (MSO_SHAPE_TYPE.DIAMOND, "菱形", Inches(4), Inches(3), Inches(2), Inches(1)),
        (MSO_SHAPE_TYPE.ROUNDED_RECTANGLE, "圆角矩形", Inches(1), Inches(5), Inches(2), Inches(1)),
        (MSO_SHAPE_TYPE.HEXAGON, "六边形", Inches(4), Inches(5), Inches(2), Inches(1)),
    ]
    
    print("添加不同类型的形状：")
    for shape_type, name, left, top, width, height in shape_configs:
        shape = shapes.add_shape(shape_type, left, top, width, height)
        shape.name = name
        print(f"  ✅ 添加了 {name}")
    
    # 保存演示文稿
    output_file = 'comprehensive_shapes_demo.pptx'
    prs.save(output_file)
    print(f"\n✅ 综合形状演示已保存：{output_file}")
    print(f"总共创建了 {len(shapes)} 个形状")
    
    # 显示形状统计
    print("\n形状统计：")
    shape_types = {}
    for shape in shapes:
        shape_type = str(shape.shape_type)
        shape_types[shape_type] = shape_types.get(shape_type, 0) + 1
    
    for shape_type, count in shape_types.items():
        print(f"  {shape_type}: {count} 个")
    
    print()


def cleanup_temp_files():
    """清理临时文件"""
    print("=== 清理临时文件 ===")
    
    temp_files = [
        'comprehensive_shapes_demo.pptx'
    ]
    
    for file in temp_files:
        if os.path.exists(file):
            os.remove(file)
            print(f"🗑️ 已删除临时文件：{file}")
    
    print("✅ 清理完成")
    print()


def main():
    """主函数：运行所有示例"""
    print("🚀 python-pptx Understanding Shapes 示例")
    print("=" * 50)
    print()
    
    try:
        # 运行所有示例
        demonstrate_shape_types()
        access_slide_shapes()
        demonstrate_shape_hierarchy()
        demonstrate_shape_properties()
        demonstrate_shape_operations()
        create_comprehensive_shape_demo()
        
        print("🎉 所有示例执行完成！")
        print("\n生成的文件：")
        for file in os.listdir('.'):
            if file.endswith('.pptx'):
                print(f"  📄 {file}")
        
        # 询问是否清理临时文件
        print("\n是否要清理临时文件？(y/n): ", end="")
        # 在实际运行中，这里可以添加用户输入处理
        # 为了演示，我们直接清理
        cleanup_temp_files()
        
    except Exception as e:
        print(f"❌ 执行过程中出现错误：{e}")
        print("请确保已安装python-pptx：pip install python-pptx")


if __name__ == "__main__":
    main()