Python在Word文档中插入图片的三种方式_Python

引言

word不仅仅是一个文字处理工具，它还为用户提供了图片插入功能，以增强文档的表现力。恰当的图片不仅能够直观地解释复杂的概念，还能显著提升文档的吸引力，使信息传达更加有效。在学术研究、项目报告和技术文档中，一张好的图片往往能够起到画龙点睛的作用，吸引读者的注意力并加深他们的理解。这篇博客将介绍使用python在word文档中插入图片的三种方式：插入图片到段落、插入图片到指定位置和插入图片到每一页。

python 插入图片到word文档的段落
python 插入图片到word文档的指定位置
python 插入图片到word文档的每一页

使用工具

要在python中插入图片到word文档，需要使用合适的word文档处理库。本文使用的库是spire.doc for python，该库允许开发者通过 python 代码操作 word 文档，包括在文档中插入、替换和删除图片等。

你可以通过在终端中运行以下命令从 pypi 安装 spire.doc for python：

pip install spire.doc

python 插入图片到word文档的段落

最简单的插入图片的方法是将其添加到现有的段落中。这使得图片成为段落的一部分，并根据段落的文本流自动调整其位置。

下面是插入图片到word文档的段落的具体步骤：

创建 document 类的对象。
使用 document.addsection() 方法添加一个节。
使用 section.addparagraph() 方法添加一个段落。
使用 paragraph.appendpicture() 方法向段落添加图片。
设置图片的宽度、高度和文本环绕样式。
使用 document.savetofile() 方法保存结果文档。

实现代码：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 创建 document 对象
    document = document()
 
    # 添加节
    section = document.addsection()
 
    # 设置页面边距
    section.pagesetup.margins.all = 72.0
 
    # 添加标题段落
    title_paragraph = section.addparagraph()
    # 设置段落文本及其格式
    text_range = title_paragraph.appendtext("python 编程语言简介")
    text_range.characterformat.fontname = "宋体"
    text_range.characterformat.textcolor = color.get_royalblue()
    title_paragraph.applystyle(builtinstyle.heading1)
    title_paragraph.format.horizontalalignment = horizontalalignment.center
    title_paragraph.format.afterspacing = 18
 
    # 添加内容段落
    content_paragraph = section.addparagraph()
    # 设置段落文本及其格式
    text_range = content_paragraph.appendtext("python是一种功能强大且用途广泛的编程语言，近年来受到越来越多的青睐。作为一种解释型高级语言，python以其简洁、易读和易用的特点著称，既适合初学者入门，也深受经验丰富的开发者喜爱。其简洁直观的语法结合强大的标准库，以及对多种编程范式的支持，使开发者能够高效完成从网页开发、数据分析到机器学习和科学计算等多种任务。借助跨平台的兼容性、活跃庞大的社区，以及日益丰富的第三方库和工具生态，python已成为全球最受欢迎、最具影响力的编程语言之一。")
    text_range.characterformat.fontname = "宋体"
    text_range.characterformat.fontsize = 12
    content_paragraph.format.horizontalalignment = horizontalalignment.justify
 
    # 插入图片
    image = content_paragraph.appendpicture("python.png")
    # 设置图片宽度和高度
    image.width = 100
    image.height = 100
    # 设置图片的文本环绕样式
    image.textwrappingstyle = textwrappingstyle.square
 
    # 保存文档
    document.savetofile("插入图片到段落.docx", fileformat.docx2019)
    print("文档保存成功。")
    document.close()
except exception as e:
    print(f"处理文档时出错: {e}")

python 插入图片到word文档的指定位置

有时我们需要将图片放置在文档的具体位置，而不是让它跟随段落文本流动。这可以通过设置图片的位置属性来实现。

下面是插入图片到word文档的指定位置的具体步骤：

创建 document 类的对象。
使用 document.addsection() 方法添加一个节。
使用 section.addparagraph() 方法添加段落。
使用 paragraph.appendpicture() 方法向段落添加图片。
设置图片的宽度、高度及文本环绕样式。
使用图片的 horizontalorigin 和 verticalorigin 属性设置其水平和垂直起点。
使用图片的 horizontalposition 和 verticalposition 属性设置绝对水平和垂直位置。
使用图片的 horizontalalignment 和 verticalalignment 属性设置水平和垂直对齐方式。
使用 document.savetofile() 方法保存结果文档。

实现代码：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 创建 document 对象
    document = document()
 
    # 添加节
    section = document.addsection()
 
    # 设置页面边距
    section.pagesetup.margins.all = 72
 
    # 向节中添加标题段落
    title_paragraph = section.addparagraph()
    # 设置段落的文本和格式
    text_range = title_paragraph.appendtext("python 编程语言简介")
    text_range.characterformat.fontname = "宋体"
    text_range.characterformat.textcolor = color.get_royalblue()
    title_paragraph.applystyle(builtinstyle.heading1)
    title_paragraph.format.horizontalalignment = horizontalalignment.center
    title_paragraph.format.afterspacing = 18
 
    # 向节中添加段落
    paragraph = section.addparagraph()
 
    # 向段落中添加内嵌图片
    image = paragraph.appendpicture("python.png")
    # 设置图片宽度和高度
    image.width = 100
    image.height = 100
    # 设置图片的文字环绕样式（注意：当文字环绕样式为inline时，图片无法设置绝对位置）
    image.textwrappingstyle = textwrappingstyle.square
 
    # 设置图片的水平和垂直起点 （在此代码中，图片的水平起点为页面左侧，水平偏移 200 磅；垂直起点为段落，垂直偏移 200 磅）
    image.horizontalorigin = horizontalorigin.page
    image.verticalorigin = verticalorigin.paragraph
    # 设置图片的绝对水平和垂直位置
    image.horizontalposition = 200
    image.verticalposition = 200
    # 设置图片的水平和垂直对齐方式
    image.horizontalalignment = shapehorizontalalignment.center
    image.verticalalignment = shapeverticalalignment.center
 
    # 保存文档
    document.savetofile("插入图片到指定位置.docx", fileformat.docx2019)
    print("文档保存成功。")
    document.close()
except exception as e:
    print(f"处理文档时出错: {e}")

python 插入图片到word文档的每一页

在某些情况下，我们可能需要将图片插入到 word 文档的每一页，比如我们希望在整个文档的每一页展示公司logo或者品牌图片。word文档本身是流式布局，没有页的概念，但可以通过将文档转换为固定布局来实现这一功能。

下面是插入图片到word文档的每一页的具体步骤：

创建 document 类的对象。
使用 document.loadfromfile() 方法加载现有的 word 文档。
创建 fixedlayoutdocument 类的对象，用于将文档转换为固定布局。
使用 fixedlayoutdocument.pages 属性获取文档的页面。
循环遍历页面。
对于每个页面，使用 fixedlayoutpage.getchildentities() 方法获取页面上的特定行，然后使用 fixedlayoutline.paragraph 属性获取该行所在的段落。
使用 paragraph.appendpicture() 方法向段落中添加图片。
设置图片的宽度、高度、文本环绕样式、水平和垂直起点、位置及对齐方式。
使用 document.savetofile() 方法保存结果文档。

实现代码：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 创建 document 对象
    document = document()
    # 加载 word 文档
    document.loadfromfile("人工智能.docx")
 
    # 创建 fixedlayoutdocument 对象，将文档转换为固定布局文档
    layoutdoc = fixedlayoutdocument(document)
    # 获取文档的页面
    pages = layoutdoc.pages
 
    # 遍历文档的页面
    for page_index in range(pages.count):
        page = pages[page_index]
        # 获取页面的行
        lines = page.getchildentities(layoutelementtype.line, true)
        if lines:
            # 获取第一行的段落
            paragraph = lines[0].paragraph
            # 向段落添加图片
            image = paragraph.appendpicture("logo.png")
            # 设置图片的宽度和高度
            image.width = 100
            image.height = 100
            # 设置图片的文本环绕样式
            image.textwrappingstyle = textwrappingstyle.behind
 
            # 设置图片的水平和垂直起点
            image.horizontalorigin = horizontalorigin.page
            image.verticalorigin = verticalorigin.paragraph
 
            # 设置图片的绝对水平和垂直位置
            image.horizontalposition = 200
            image.verticalposition = 150
            # 设置图片的水平和垂直对齐方式
            image.horizontalalignment = shapehorizontalalignment.center
            image.verticalalignment = shapeverticalalignment.center
 
    # 将文档保存到文件
    document.savetofile("插入图片到每一页.docx", fileformat.docx2019)
    print("文档保存成功。")
    document.close()
except exception as e:
    print(f"处理文档时出错: {e}")