python-pptx 中高效定位和操作幻灯片内容占位符

from pptx import Presentation
from pptx.util import Inches
from pptx.enum.text import PpPlaceholderType # 导入占位符类型枚举
from pptx.enum.dml import MSO_THEME_COLOR
from pptx.enum.text import MSO_AUTO_SIZE, PP_ALIGN

# 创建一个新的演示文稿
prs = Presentation()

# 推荐通过名称查找“标题和内容”布局，以提高代码健壮性
slide_layout = None
for layout in prs.slide_layouts:
    if "Title and Content" in layout.name:
        slide_layout = layout
        break

# 如果未找到特定名称的布局，则回退到默认索引（通常为1）
if slide_layout is None:
    slide_layout = prs.slide_layouts[1]

slide = prs.slides.add_slide(slide_layout)

# 方式一：使用 title 属性访问标题占位符
title_placeholder_by_attr = slide.shapes.title
title_placeholder_by_attr.text = "Python-pptx 教程：内容占位符操作"

# 方式二：使用 placeholders 集合的索引（标题通常是第一个占位符）
# title_placeholder_by_index = slide.shapes.placeholders[0]
# title_placeholder_by_index.text = "Python-pptx 教程：内容占位符操作 (通过索引)"

print(f"标题占位符类型: {title_placeholder_by_attr.placeholder_format.type}")

# content_placeholder = slide.shapes.placeholders[1]
# content_placeholder.text = "这是幻灯片的主体内容。"

# ... (接上面的 slide 创建代码) ...

content_placeholder = None
for shape in slide.shapes:
    if shape.is_placeholder:
        # 尝试通过占位符类型识别内容框
        if shape.placeholder_format.type in (PpPlaceholderType.BODY, PpPlaceholderType.CONTENT):
            content_placeholder = shape
            break

if content_placeholder:
    text_frame = content_placeholder.text_frame
    text_frame.clear() # 清除现有内容，确保从空白开始

    # 添加第一个段落
    p1 = text_frame.paragraphs[0]
    p1.text = "本教程将指导您如何通过 Python 编程，使用 python-pptx 库来自动化创建和编辑 PowerPoint 演示文稿。"
    p1.font.size = Inches(0.2) # 设置字体大小
    p1.font.name = "微软雅黑"
    p1.font.color.rgb = MSO_THEME_COLOR.TEXT_1
    p1.alignment = PP_ALIGN.LEFT

    # 添加第二个段落作为列表项
    p2 = text_frame.add_paragraph()
    p2.text = "核心内容包括：定位标题和内容占位符。"
    p2.level = 1 # 设置为一级列表
    p2.font.size = Inches(0.18)
    p2.font.name = "微软雅黑"

    # 添加第三个段落作为列表项
    p3 = text_frame.add_paragraph()
    p3.text = "使用占位符类型（如 PpPlaceholderType.BODY）进行更精确的识别。"
    p3.level = 1
    p3.font.size = Inches(0.18)
    p3.font.name = "微软雅黑"

    # 调整文本框的自动调整大小行为，以适应内容
    text_frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT

    print(f"内容占位符类型: {content_placeholder.placeholder_format.type}")
else:
    print("未能在当前幻灯片中找到主体内容占位符。")

# 保存演示文稿
prs.save("python_pptx_tutorial_output.pptx")
print("演示文稿已保存为 python_pptx_tutorial_output.pptx")