使用python修改PPT文本框的name

发表于 更新于 分类于

前言

临时接到了一个需求，需要使用 PPT 做一个展示界面，PPT 画完了，通过 VBA 脚本请求 RESTful 接口来控制画面中文本框的数值和颜色变化，这就需要将 PPT 中文本框原始的 文本框 xx 修改为有意义的值，方便在循环中使用 VBA 去设置值和更改颜色。

image-20201112150919614

寻找需要修改的节点

使用的 PPT 版本是 2016 版本，PPT 文件是一个压缩包的形式（PPT 2007 以下是二进制格式，不能直接打开），可以解压缩查看里面的 xml 文件内容。

首先先将 PPT 文件解压，然后找到 xxx.pptm\ppt\slides\路径中的 slide1.xml 文件，文件中的内容就是第一张 PPT 的内容，使用合适的文本查看器打开并且格式化为易于查看的格式，搜索 文本框 xx，找到文本框节点，如图所示：

image-20201112135901625

可以看到文本框节点由 <p:sp> 节点包裹，里面由三个子节点 <p:nvSpPr>、<p:spPr>、<p:txBody>组成。

  • <p:nvSpPr> 节点中存储的内容为文本框 ID 和 name，我们需要修改的内容就在这里
  • <p:spPr> 节点中存储的内容为文本框的坐标信息
  • <p:txBody> 节点中存储的内容为文本框中的文字，可能还有其他的字体和颜色信息，由于我的是默认设置，就不深究了

修改节点信息

找到了需要修改的节点后，需要写一个程序来解析并且遍历 xml 节点，判断是否需要修改，之后进行对应的修改。解析 xml 文件可以使用 lxml 这个库，修改节点信息也可以使用它。

不过由于是 PPT 文件，应该已经有了现成的读写库，为了避免重复造轮子，搜索了一下，找到了 python-pptx 这个库。

python-pptx库

安装应该就不用说了，使用命令 pip install python-pptx 安装就可以了，会自动安装好 lxml、Pillow、XlsxWriter 这三个依赖库。

快速浏览了一下文档，没有找到符合我们需求（修改文本框节点名字）的函数或者属性，只找到了输出所有文本框中所有文字的例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from pptx import Presentation

prs = Presentation('d:/xxxxxx/1.pptm')

# text_runs will be populated with a list of strings,
# one for each text run in presentation
text_runs = []

for slide in prs.slides:  # 获取所有的ppt画面
    for shape in slide.shapes:  # 获取每个ppt画面中所有的图形
        if not shape.has_text_frame:  # 判断是否是含有文字的对象
            continue
        for paragraph in shape.text_frame.paragraphs:  # 获取所有的文字
            for run in paragraph.runs:
                text_runs.append(run.text)
print(text_runs)

运行它，输出了当前 PPT 中所有的文本框中的所有文字，如图：

image-20201112141430369

寻找name属性

既然没有详细文档，那么就去翻源码好了，源码中肯定有根据节点定义好的各种属性可以直接调用。

根据刚才找到的线索节点 <p:nvSpPr> 下的 <p:cNvPr> 去源码中搜索全部文件，如图：

image-20201112142044064

在 12 个文件中搜索到了 14处，挨个看看。经过漫长的寻找，最后找到了一个关键点，如图：

image-20201112142611968

熟悉的 cNvPr，熟悉的 name 属性，不出意外就是它了。

找到它的类 BaseShapeElement，发现它是好多类的父类，也就是说这是一个基础属性，基本上每个节点都会有的。

下断点，运行上面的代码，查找 name 属性，可以看到找到了我们需要修改的 name 属性，在 shape 对象中，如图：

image-20201112143640227

修改name属性

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from pptx import Presentation

prs = Presentation('d:/xxxxx/1.pptm')

# text_runs will be populated with a list of strings,
# one for each text run in presentation
text_runs = []

for slide in prs.slides:  # 获取所有的ppt画面
    for shape in slide.shapes:  # 获取每个ppt画面中所有的图形
        if not shape.has_text_frame:  # 判断是否是含有文字的对象
            continue
        for paragraph in shape.text_frame.paragraphs:  # 获取所有的文字
            for run in paragraph.runs:
                text_runs.append(run.text)
+       shape.name = 'test_shape'
print(text_runs)
prs.save('d:/xxxx/2.pptm')

找到了 name 属性在哪里就好办多了， 添加一行代码，将 name 属性修改为我们所需要的名字即可（根据需求进行判断修改，此处仅为测试），不要忘了保存。

修改前：

image-20201112144238183

修改后：

image-20201112144303978

总结

python-pptx 库还是比较好用的，可以使用它来批量生成工作中的 PPT 文档，可以批量修改文本框的 name 或者修改一些其他形状的颜色位置大小等等信息，在批量操作 PPT 文档时相当有效！

参考链接

https://python-pptx.readthedocs.io/en/latest/index.html

本文章首发于个人博客 LLLibra146’s blog
本文作者：LLLibra146
更多文章请关注：qrcode
版权声明：本博客所有文章除特别声明外，均采用 © BY-NC-ND 许可协议。非商用转载请注明出处！严禁商业转载！
本文链接：
https://blog.d77.xyz/archives/acedef7b.html