Python InDesign脚本如何执行预检检查 排查文本框溢出问题

报错原因 #

你遇到的Missing required parameter 'TargetObject'报错是因为Python调用InDesign COM接口时，参数传递规则和原生ExtendScript不同：ExtendScript支持隐式的位置参数匹配，但Python的win32com调用场景下，PreflightProcesses.Add方法要求必须显式指定参数名，不能直接按位置传参。

方案1：直接遍历文本框检查溢出（更简单高效） #

如果仅需要检查文本框内容溢出，不需要完整的预检功能，可以直接遍历文档内所有文本框判断Overflows属性，实现逻辑更简单，执行速度也更快：

import win32com.client

# 连接InDesign实例，版本号对应你本地安装的InDesign版本
app = win32com.client.Dispatch("InDesign.Application.CC.2024")
# 打开目标文档，替换为你本地的文档路径
myDocument = app.Open(r"C:\path\to\your\document.indd")

overflow_frames = []
# 遍历文档所有页面
for page in myDocument.Pages:
    # 遍历当前页面所有文本框
    for frame in page.TextFrames:
        if frame.Overflows:
            overflow_frames.append(f"页面{page.Name}的文本框（ID：{frame.Id}）")

if overflow_frames:
    print("检测到以下溢出文本框：")
    for info in overflow_frames:
        print(info)
else:
    print("未检测到内容溢出的文本框")

方案2：修复预检方法调用 #

如果需要依托预检框架实现检查，只需调整参数传递方式，显式指定参数名即可解决报错：

import win32com.client

app = win32com.client.Dispatch("InDesign.Application.CC.2024")
myDocument = app.Open(r"C:\path\to\your\document.indd")

# 调用内置的基础预检配置，也可替换为你自定义的配置名称
myProfile = app.PreflightProfiles.ItemByName("基本")
# 显式指定参数名调用Add方法
myPreflight = app.PreflightProcesses.Add(TargetObject=myDocument, PreflightProfile=myProfile)
# 等待预检进程执行完成
myPreflight.WaitForProcess()

# 筛选文本溢出类型的报错（错误码94116对应文本溢出）
overflow_errors = myPreflight.PreflightResults.Results.Filter(94116)
if overflow_errors.Count > 0:
    print(f"预检共检测到{overflow_errors.Count}处文本溢出")
else:
    print("未检测到文本溢出")

# 清理创建的预检进程
myPreflight.Delete()

内容的提问来源于stack exchange，提问作者Felix Schön