21-添加图像
15.3.9 添加图像
Document
对象有一个 add_picture()
方法,可以让你在文档末尾添加图像。假定当前工作目录中有一个文件zophie.png,你可以输入以下代码,在文档末尾添加zophie.png,宽度为1英寸,高度为4厘米(Word可以同时使用英制和公制单位):
>>> doc.add_picture('zophie.png', width=docx.shared.Inches(1),
height=docx.shared.Cm(4))
<docx.shape.InlineShape object at 0x00000000036C7D30>
第一个参数是一个字符串,表示图像的文件名。可选的 width
和 height
关键字参数将设置该图像在文档中的宽度和高度;如果省略,宽度和高度将采用默认值,即该图像的正常尺寸。
你可能愿意用熟悉的单位来指定图像的高度和宽度,如英寸或厘米。所以在指定 width
和 height
关键字参数时,可以使用 docx.shared.Inches()
和 docx.shared.Cm()
函数。