一、布局基礎概念

在 PowerPoint 中，布局（Layout） 決定了幻燈片的占位符（如標題、內容、圖片等）的排列方式。python-pptx 提供了對布局的編程控制。

---

二、默認布局類型及索引

通過 prs.slide_layouts[index] 訪問，以下是常見默認布局（不同模板可能有變化）：

索引	布局名稱	包含占位符	備注
0	Title Slide	主標題 + 副標題
1	Title and Content	標題 + 正文/圖片/圖表
2	Section Header	章節標題 + 描述文字
3	Two Content	標題 + 左右兩欄內容
5	Title Only	僅標題
6	Blank	空白幻燈片
7	Content with Caption	標題 + 圖片 + 底部說明文字
8	Picture with Caption	標題 + 大圖 + 底部文字

---

三、代碼實戰：布局操作

1. 查看所有布局

from pptx import Presentationprs = Presentation()
for idx, layout in enumerate(prs.slide_layouts):print(f"Layout {idx}: {layout.name}")for shape in layout.placeholders:print(f"  - 占位符類型: {shape.placeholder_format.type}")

2. 添加帶標題和內容的幻燈片

slide = prs.slides.add_slide(prs.slide_layouts[1])  # Title and Content
slide.shapes.title.text = "這是標題"
content = slide.placeholders[1]  # 內容占位符
content.text = "第一點\n第二點"  # 或插入圖片/圖表

3. 強制修改布局元素

如果布局不包含所需占位符，手動添加：

from pptx.util import Inchesslide = prs.slides.add_slide(prs.slide_layouts[6])  # Blank
# 手動添加標題
title_box = slide.shapes.add_textbox(Inches(1), Inches(0.5), Inches(8), Inches(1))
title_box.text = "自定義標題"

---

四、布局選擇策略

場景	推薦布局	代碼示例
封面頁	Layout 0 (Title Slide)	prs.slide_layouts[0]
圖文混合頁	Layout 1 (Title and Content)	prs.slide_layouts[1]
純圖片展示	Layout 8 (Picture with Caption)	prs.slide_layouts[8]
分欄內容	Layout 3 (Two Content)	prs.slide_layouts[3]
自定義自由排版	Layout 6 (Blank)	prs.slide_layouts[6]

---

五、高級技巧

1. 檢查占位符是否存在

slide = prs.slides.add_slide(prs.slide_layouts[1])
if slide.shapes.title:print("當前布局包含標題占位符")

2. 替換占位符為圖片

slide = prs.slides.add_slide(prs.slide_layouts[1])
slide.shapes.title.text = "數據報告"
picture = slide.placeholders[1].insert_picture("chart.png")

3. 自定義布局（需修改模板）

1. 在 PowerPoint 中設計自定義布局并保存為 .pptx 文件
2. 代碼加載自定義模板：

   prs = Presentation("custom_template.pptx")
   slide = prs.slides.add_slide(prs.slide_layouts[10])  # 假設自定義布局索引為10
   

---

六、常見問題

Q1：為什么 slide.shapes.title 返回 None？

• 原因：當前布局無標題占位符
• 解決：換用含標題的布局（如索引0/1/5），或手動添加文本框

Q2：如何調整占位符位置？

• 通過 placeholder.element.getparent().remove() 刪除原有占位符
• 用 add_textbox() 或 add_picture() 自定義位置

Q3：布局與主題的關系？

• 布局依賴于主題（Theme），更換主題可能影響占位符樣式