如何检测python-pptx中两个文本占位符的文本重叠问题

核心思路 #

python-pptx仅负责操作PPT的XML结构，不处理渲染逻辑，因此无法直接获取文本填充后的实际形状高度。最可靠的方案是借助PowerPoint的COM接口（通过pywin32包），让PowerPoint自身计算出文本自动调整后的真实尺寸，再判断重叠并调整位置。

步骤实现 #

1. 先用python-pptx完成文本填充，保存初始PPT文件。
2. 通过win32com.client启动PowerPoint实例，打开保存的PPT。
3. 获取目标幻灯片的文本占位符，读取PowerPoint计算好的实际位置与尺寸。
4. 判断两个垂直排列的形状是否重叠，若重叠则调整下方形状的位置。
5. 保存修改后的PPT并关闭PowerPoint实例。

完整代码示例 #

import time
import os
import win32com.client as win32
from pptx import Presentation as pptx_Presentation
from pptx.enum.text import MSO_AUTO_SIZE

def get_date_time_str():
    """返回当前时间的字符串格式：%Y%m%d-%H%M%S"""
    return time.strftime("%Y%m%d-%H%M%S", time.localtime())

# --- 第一步：用python-pptx生成初始PPT ---
long_text = "F" * 60
empty_pptx = r"C:\f\empty.pptx"  # 包含"Sections"布局的空白PPT
output_pptx = rf"C:\f\out-{get_date_time_str()}.pptx"

prs = pptx_Presentation(empty_pptx)
slide_layout = prs.slide_layouts[1]

# 示例1：直接设置文本框内容
slide1 = prs.slides.add_slide(slide_layout)
for shape in slide1.shapes:
    shape.text_frame.text = long_text
    shape.text_frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT

# 示例2：按段落设置文本
slide2 = prs.slides.add_slide(slide_layout)
pars_data = [long_text for _ in range(3)]
wrap = True

for shape in slide2.shapes:
    text_frame = shape.text_frame
    text_frame.word_wrap = wrap
    text_frame.paragraphs[0].text = pars_data[0]
    for par_data in pars_data[1:]:
        par = text_frame.add_paragraph()
        par.text = par_data
    text_frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT

prs.save(output_pptx)
print(f"初始PPT已保存至：{output_pptx}")

# --- 第二步：用PowerPoint COM接口调整重叠的文本框 ---
def adjust_overlapping_shapes(pptx_path):
    # 启动PowerPoint实例
    powerpoint = win32.Dispatch("PowerPoint.Application")
    powerpoint.Visible = True  # 调试时设为True可查看操作过程，发布时可改为False

    # 打开PPT文件
    presentation = powerpoint.Presentations.Open(pptx_path)

    # 遍历每一页幻灯片
    for slide in presentation.Slides:
        # 获取当前页的文本类形状（占位符/文本框）
        text_shapes = [shape for shape in slide.Shapes if shape.Type in (1, 2)]  # 1=占位符，2=文本框
        if len(text_shapes) < 2:
            continue

        # 按垂直位置排序，Top值越小越靠上
        text_shapes.sort(key=lambda s: s.Top)
        shape_top = text_shapes[0]
        shape_bottom = text_shapes[1]

        # 计算形状垂直范围：上方形状底部 = Top + Height
        top_shape_bottom = shape_top.Top + shape_top.Height
        bottom_shape_top = shape_bottom.Top

        # 判断是否重叠
        if top_shape_bottom > bottom_shape_top:
            # 调整下方形状位置，添加10磅间距
            spacing = 10
            new_bottom_top = top_shape_bottom + spacing
            shape_bottom.Top = new_bottom_top
            print(f"幻灯片{slide.SlideIndex}的文本框已调整位置")

    # 保存修改并关闭
    presentation.Save()
    presentation.Close()
    powerpoint.Quit()
    print(f"调整后的PPT已保存至：{pptx_path}")

# 执行调整操作
adjust_overlapping_shapes(output_pptx)

关键说明 #

• 需提前安装pywin32：pip install pywin32
• 依赖本地安装的Microsoft PowerPoint，COM接口需要PPT环境支持
• 代码中shape.Type的取值：1代表占位符，2代表纯文本框，可根据实际形状类型调整
• 调整间距的单位为磅（Point），1磅≈0.35毫米，可按需修改spacing值

内容的提问来源于stack exchange，提问作者martin-voj