Python在Word文檔中插入圖片的三種方式

更新時間：2025年02月13日 10:39:42 作者：nuclear2011

Word不僅僅是一個文字處理工具,它還為用戶提供了圖片插入功能,以增強文檔的表現(xiàn)力,一張好的圖片往往能夠起到畫龍點睛的作用,這篇博客將介紹使用Python在Word文檔中插入圖片的三種方式,需要的朋友可以參考下

引言

Word不僅僅是一個文字處理工具，它還為用戶提供了圖片插入功能，以增強文檔的表現(xiàn)力。恰當?shù)膱D片不僅能夠直觀地解釋復雜的概念，還能顯著提升文檔的吸引力，使信息傳達更加有效。在學術研究、項目報告和技術文檔中，一張好的圖片往往能夠起到畫龍點睛的作用，吸引讀者的注意力并加深他們的理解。這篇博客將介紹使用Python在Word文檔中插入圖片的三種方式：插入圖片到段落、插入圖片到指定位置和插入圖片到每一頁。

Python 插入圖片到Word文檔的段落
Python 插入圖片到Word文檔的指定位置
Python 插入圖片到Word文檔的每一頁

使用工具

要在Python中插入圖片到Word文檔，需要使用合適的Word文檔處理庫。本文使用的庫是Spire.Doc for Python，該庫允許開發(fā)者通過 Python 代碼操作 Word 文檔，包括在文檔中插入、替換和刪除圖片等。

你可以通過在終端中運行以下命令從 PyPI 安裝 Spire.Doc for Python：

pip install Spire.Doc

Python 插入圖片到Word文檔的段落

最簡單的插入圖片的方法是將其添加到現(xiàn)有的段落中。這使得圖片成為段落的一部分，并根據(jù)段落的文本流自動調整其位置。

下面是插入圖片到Word文檔的段落的具體步驟：

創(chuàng)建 Document 類的對象。
使用 Document.AddSection() 方法添加一個節(jié)。
使用 Section.AddParagraph() 方法添加一個段落。
使用 Paragraph.AppendPicture() 方法向段落添加圖片。
設置圖片的寬度、高度和文本環(huán)繞樣式。
使用 Document.SaveToFile() 方法保存結果文檔。

實現(xiàn)代碼：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 創(chuàng)建 Document 對象
    document = Document()
 
    # 添加節(jié)
    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以其簡潔、易讀和易用的特點著稱，既適合初學者入門，也深受經驗豐富的開發(fā)者喜愛。其簡潔直觀的語法結合強大的標準庫，以及對多種編程范式的支持，使開發(fā)者能夠高效完成從網頁開發(fā)、數(shù)據(jù)分析到機器學習和科學計算等多種任務。借助跨平臺的兼容性、活躍龐大的社區(qū)，以及日益豐富的第三方庫和工具生態(tài)，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
    # 設置圖片的文本環(huán)繞樣式
    image.TextWrappingStyle = TextWrappingStyle.Square
 
    # 保存文檔
    document.SaveToFile("插入圖片到段落.docx", FileFormat.Docx2019)
    print("文檔保存成功。")
    document.Close()
except Exception as e:
    print(f"處理文檔時出錯: {e}")

Python 插入圖片到Word文檔的指定位置

有時我們需要將圖片放置在文檔的具體位置，而不是讓它跟隨段落文本流動。這可以通過設置圖片的位置屬性來實現(xiàn)。

下面是插入圖片到Word文檔的指定位置的具體步驟：

創(chuàng)建 Document 類的對象。
使用 Document.AddSection() 方法添加一個節(jié)。
使用 Section.AddParagraph() 方法添加段落。
使用 Paragraph.AppendPicture() 方法向段落添加圖片。
設置圖片的寬度、高度及文本環(huán)繞樣式。
使用圖片的 HorizontalOrigin 和 VerticalOrigin 屬性設置其水平和垂直起點。
使用圖片的 HorizontalPosition 和 VerticalPosition 屬性設置絕對水平和垂直位置。
使用圖片的 HorizontalAlignment 和 VerticalAlignment 屬性設置水平和垂直對齊方式。
使用 Document.SaveToFile() 方法保存結果文檔。

實現(xiàn)代碼：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 創(chuàng)建 Document 對象
    document = Document()
 
    # 添加節(jié)
    section = document.AddSection()
 
    # 設置頁面邊距
    section.PageSetup.Margins.All = 72
 
    # 向節(jié)中添加標題段落
    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
 
    # 向節(jié)中添加段落
    paragraph = section.AddParagraph()
 
    # 向段落中添加內嵌圖片
    image = paragraph.AppendPicture("Python.png")
    # 設置圖片寬度和高度
    image.Width = 100
    image.Height = 100
    # 設置圖片的文字環(huán)繞樣式（注意：當文字環(huán)繞樣式為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文檔本身是流式布局，沒有頁的概念，但可以通過將文檔轉換為固定布局來實現(xiàn)這一功能。

下面是插入圖片到Word文檔的每一頁的具體步驟：

創(chuàng)建 Document 類的對象。
使用 Document.LoadFromFile() 方法加載現(xiàn)有的 Word 文檔。
創(chuàng)建 FixedLayoutDocument 類的對象，用于將文檔轉換為固定布局。
使用 FixedLayoutDocument.Pages 屬性獲取文檔的頁面。
循環(huán)遍歷頁面。
對于每個頁面，使用 FixedLayoutPage.GetChildEntities() 方法獲取頁面上的特定行，然后使用 FixedLayoutLine.Paragraph 屬性獲取該行所在的段落。
使用 Paragraph.AppendPicture() 方法向段落中添加圖片。
設置圖片的寬度、高度、文本環(huán)繞樣式、水平和垂直起點、位置及對齊方式。
使用 Document.SaveToFile() 方法保存結果文檔。

實現(xiàn)代碼：

from spire.doc import *
from spire.doc.common import *
 
try:
    # 創(chuàng)建 Document 對象
    document = Document()
    # 加載 Word 文檔
    document.LoadFromFile("人工智能.docx")
 
    # 創(chuàng)建 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
            # 設置圖片的文本環(huán)繞樣式
            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}")