python办公自动化：使用`python-docx`处理图像与形状

图像与形状是丰富文档内容的重要元素，python-docx 提供了强大的功能来插入和操作图像与形状，使文档更加生动和直观。本章将详细介绍如何使用 python-docx 处理图像和形状，包括插入、调整大小、定位、添加形状、以及对这些元素进行格式化。

1 插入图像

在文档中插入图像是常见的需求，python-docx 提供了简单的接口来实现这一功能。

1.1 基本图像插入

要在文档中插入图像，可以使用 add_picture() 方法：

from docx import Document

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

# 插入图像
doc.add_picture('path/to/image.png')

1.2 控制图像大小

python-docx 允许您在插入图像时指定图像的宽度和高度：

from docx.shared import Inches

# 插入并设置宽度为2英寸的图像，高度将按比例缩放
doc.add_picture('path/to/image.png', width=Inches(2))

# 插入并设置高度为1英寸的图像，宽度将按比例缩放
doc.add_picture('path/to/image.png', height=Inches(1))

如果同时指定宽度和高度，图像将会被拉伸或压缩到指定的尺寸。

1.3 插入图片后添加说明文字

插入图像后，通常需要为其添加说明文字。可以使用 add_paragraph() 来实现：

# 插入图像
doc.add_picture('path/to/image.png', width=Inches(2))

# 添加说明文字
doc.add_paragraph("图1: 这是图片的说明文字。", style='Caption')

这种方式可以有效地描述图像内容，使文档更具可读性。

2 调整图像的格式与定位

插入图像后，可以通过调整图像的格式和定位来提升文档的视觉效果。

2.1 设置图片的对齐方式

图像的对齐方式可以通过调整其所在段落的对齐方式来实现：

from docx.enum.text import WD_ALIGN_PARAGRAPH

# 插入图像并居中对齐
image = doc.add_picture('path/to/image.png', width=Inches(2))
last_paragraph = doc.paragraphs[-1]
last_paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

您可以选择将图像左对齐、居中对齐、右对齐或两端对齐。

2.2 设置图片环绕方式

虽然 python-docx 不直接支持图像的环绕设置，但可以通过手动调整图像的段落格式来间接控制图像与文字的布局。

2.3 添加图片边框

在某些情况下，可能需要为图像添加边框，python-docx 可以通过操作底层的XML来实现这一功能：

from docx.oxml import OxmlElement

# 添加图像
image = doc.add_picture('path/to/image.png', width=Inches(2))

# 添加边框
inline_shape = doc.paragraphs[-1].runs[0]._inline
inline_shape_graphic = inline_shape.graphic
graphic_data = inline_shape_graphic.graphicData
pic = graphic_data.getchildren()[0]
spPr = pic.spPr
ln = OxmlElement('a:ln')
ln.set('w', '12700')  # 设置边框宽度
spPr.append(ln)

3 插入形状与文本框

python-docx 还支持插入简单的形状与文本框，这些元素可以用来创建更复杂的文档结构和布局。

3.1 插入形状

虽然 python-docx 的形状支持有限，但您可以通过访问底层XML结构手动插入形状，如矩形、圆形等：

from docx.oxml.ns import nsdecls
from docx.oxml import parse_xml

# 创建一个矩形形状并插入到文档中
doc = Document()
p = doc.add_paragraph()
r = p.add_run()
inline = r.add_drawing()
inline.graphic.graphicData.uri = nsdecls('pic')
shape = parse_xml(r'<w:pict><v:rect style="width:100pt;height:50pt;"/></w:pict>')
inline._inline.append(shape)

3.2 插入文本框

插入文本框的过程类似于插入形状，可以通过操作底层XML来实现：

# 插入文本框
doc = Document()
p = doc.add_paragraph()
r = p.add_run()
textbox = OxmlElement('w:pict')
textbox_shape = OxmlElement('v:rect')
textbox_shape.set('style', 'width:200pt;height:50pt')
textbox.append(textbox_shape)
p._element.append(textbox)

3.3 调整形状和文本框的格式

您可以通过操作XML属性来调整形状和文本框的颜色、边框、填充等属性：

# 设置文本框的填充颜色
textbox_shape.set('fillcolor', '#FF0000')  # 红色填充

# 设置文本框的边框颜色和宽度
textbox_shape.set('stroke', '#0000FF')  # 蓝色边框
textbox_shape.set('strokewidth', '2pt')  # 边框宽度

4 操作已存在的图像与形状

python-docx 允许您访问和操作文档中已存在的图像与形状，这在需要修改现有文档时非常有用。

4.1 获取文档中的所有图像

您可以遍历文档中的段落，获取所有插入的图像：

for paragraph in doc.paragraphs:
    for run in paragraph.runs:
        if run.element.xpath('.//pic:pic'):
            print("Found an image:", run.text)

4.2 修改图像属性

在获取图像后，您可以对其进行修改，例如调整大小或更改位置：

# 遍历并修改图像的宽度
for paragraph in doc.paragraphs:
    for run in paragraph.runs:
        if run.element.xpath('.//pic:pic'):
            inline_shape = run._inline
            inline_shape.ext.width = Inches(1.5)

4.3 操作已存在的形状与文本框

操作形状与文本框与操作图像类似，您可以访问文档的XML结构，找到相应的元素并进行修改。

5 图像与形状的高级操作

在高级应用中，您可能需要更复杂的图像与形状操作，如组合图形、使用模板、或批量处理。

1 从模板插入图像与形状

通过使用模板，您可以将预定义的图像与形状插入到文档中：

from docx import Document

# 使用模板创建文档
template = Document('template.docx')

# 插入图像或形状
template.add_picture('path/to/image.png', width=Inches(2))

2 批量插入与处理图像

如果需要批量插入或处理图像，可以使用循环结构来简化操作：

image_paths = ['image1.png', 'image2.png', 'image3.png']

for image_path in image_paths:
    doc.add_picture(image_path, width=Inches(2))

这种方法适用于处理大量图像的文档，极大地提高了工作效率。