Python 使用总结之 docx 添加图片设置图片大小详解

Python 使用总结之 docx 添加图片设置图片大小详解

在日常的文档处理中，我们经常需要在 Word 文档中插入图片，并根据需要调整图片的大小。在 Python 中，我们可以使用 python-docx 库来方便地实现这一功能。本文将详细介绍如何使用 python-docx 库在 Word 文档中添加图片并设置图片的大小。

安装 python-docx

首先，我们需要安装 python-docx 库。可以使用以下命令进行安装：

pip install python-docx

创建一个新的 Word 文档并添加图片

接下来，我们将展示如何创建一个新的 Word 文档，并在其中添加一张图片。

from docx import Document
from docx.shared import Inches

# 创建一个新的文档
doc = Document()

# 添加标题
doc.add_heading('Python 使用总结之 docx 添加图片设置图片大小详解', level=1)

# 添加段落
doc.add_paragraph('在本节中，我们将展示如何使用 python-docx 库在 Word 文档中添加图片并设置图片的大小。')

# 添加图片并设置大小
doc.add_picture('path/to/image.jpg', width=Inches(4.0), height=Inches(3.0))

# 保存文档
doc.save('add_image_example.docx')

详细解释

1. 导入所需模块: 我们首先从 docx 模块中导入 Document 类，以及从 docx.shared 模块中导入 Inches 类。Inches 类用于设置图片的尺寸。

2. 创建文档对象: 使用 Document() 函数创建一个新的文档对象。

3. 添加标题和段落: 使用 add_heading 方法添加标题，add_paragraph 方法添加段落内容。

4. 添加图片并设置大小: 使用 add_picture 方法添加图片。add_picture 方法的第一个参数是图片的路径，width 和 height 参数用于设置图片的宽度和高度。这里我们使用 Inches 类将尺寸设置为 4 英寸宽和 3 英寸高。你也可以使用 Cm 类（厘米）或 Pt 类（磅）来设置尺寸。

5. 保存文档: 使用 save 方法保存文档。

进一步调整图片的大小

有时，我们可能只想设置图片的宽度或高度，而让另一个维度自动调整以保持图片的纵横比。下面是一个例子：

# 只设置图片宽度，高度按比例自动调整
doc.add_picture('path/to/image.jpg', width=Inches(4.0))

# 只设置图片高度，宽度按比例自动调整
doc.add_picture('path/to/another_image.jpg', height=Inches(3.0))

总结

使用 python-docx 库，我们可以方便地在 Word 文档中添加图片并设置图片的大小。通过调整 width 和 height 参数，我们可以精确控制图片的显示尺寸。这在制作报告、演示文档和其他需要包含图片的文档时非常有用。

希望本文对你使用 python-docx 库处理图片有所帮助。如果你有任何问题或建议，欢迎在评论区留言讨论。

Happy Coding!