使用 Python 将图像插入 Word 文档的 3 种方法

摘要：“一张图片胜过千言万语”这句格言在文档创建领域适用。通过在 Word 文档中战略性地放置相关图像，您可以分解密集的文本，提供视觉上下文，并最终提高读者对内容的理解。这在传达复杂想法或呈现复杂数据时尤其有价值。

“一张图片胜过千言万语”这句格言在文档创建领域适用。通过在 Word 文档中战略性地放置相关图像，您可以分解密集的文本，提供视觉上下文，并最终提高读者对内容的理解。这在传达复杂想法或呈现复杂数据时尤其有价值。

要使用 Python 将图像插入 Word 文档，我们可以使用 Spire.Doc for Python 库。

Spire.Doc for Python 是一个功能丰富且易于使用的库，用于在 Python 应用程序中创建、读取、编辑和转换 Word 文件。使用此库，您可以使用多种 Word 格式，包括 Doc、Docx、Docm、Dot、Dotx、Dotm 等。此外，您还可以将 Word 文档渲染为其他类型的文件格式，例如 PDF、RTF、HTML、文本、图像、SVG、ODT、PostScript、PCL 和 XPS。

您可以通过在终端中运行以下命令从 PyPI 安装 Spire.Doc for Python：

pip install Spire.Doc

有关安装的更多详细信息，您可以查看此官方文档：如何在 VS Code 中为 Python 安装 Spire.Doc。

内嵌图像是 Microsoft Word 中最常见的图像插入类型。当您插入内嵌图像时，它将成为文本流的一部分，这意味着当您编辑文档时，它将与周围的段落一起移动。此方法非常适合要集成到文本正文中的图像，例如说明特定点或拆分较长的内容部分。

要使用 Python 将内嵌图像插入 Word 文档，请遵循以下关键步骤：

创建新的 document 对象。使用 Document.AddSection 函数添加部分。使用 Section.AddParagraph 函数添加段落。使用 Paragraph.AppendPicture 函数向段落添加图像。设置图像的宽度、高度和文本环绕样式。使用 Document.SaveToFile 函数将结果保存到文件中。

以下是在 Python 中将内嵌图像插入 Word 文档的简单示例：

from spire.doc import *from spire.doc.common import *# Create an object of the Document classdocument = Document# Add a sectionsection = document.AddSection# Set page marginssection.PageSetup.Margins.All = 72# Add a title paragraph to the sectiontitle_paragraph = section.AddParagraph# Set text and format for the paragraphtext_range = title_paragraph.AppendText("Introduction to Python Programming Language")text_range.CharacterFormat.FontName = "Calibri"text_range.CharacterFormat.TextColor = Color.get_RoyalBluetitle_paragraph.ApplyStyle(BuiltinStyle.Heading1)title_paragraph.Format.horizontalAlignment = HorizontalAlignment.Centertitle_paragraph.Format.AfterSpacing = 18# Add a content paragraph to the sectioncontent_paragraph = section.AddParagraph# Set text and format for the paragraphtext_range = content_paragraph.AppendText("Python is a powerful and versatile programming language that has become increasingly popular in recent years. It is an interpreted, high-level language known for its simplicity, readability, and ease of use, making it an excellent choice for beginners and experienced developers alike. Python's clean and concise syntax, combined with its extensive standard library and support for multiple programming paradigms, allow programmers to be highly productive and efficiently tackle a wide range of tasks, from web development and data analysis to machine learning and scientific computing. With its cross-platform compatibility, large and active community, and constantly-expanding ecosystem of third-party libraries and tools, Python has solidified its position as one of the most widely-used and influential programming languages in the world.")text_range.CharacterFormat.FontName = "Calibri"text_range.CharacterFormat.FontSize = 12content_paragraph.Format.HorizontalAlignment = HorizontalAlignment.Justify# Add an image to the content paragraphimage = content_paragraph.AppendPicture("Python.png")# Set image width and heightimage.Width = 100image.Height = 100# Set text wrapping style for the imageimage.TextWrappingStyle = TextWrappingStyle.Square# Save the document to a Filetry: document.SaveToFile("AddInlineImage.docx", FileFormat.Docx2019) document.Closeexcept Exception as e: print(f"Error saving document: {e}")

使用 Python 将内联图像添加到 Word

与内嵌图像相比，Microsoft Word 中绝对定位的图像是独立于周围文本放置的。这些图像在页面上保持固定位置，允许您将它们分层在文本之上或将它们放置在特定位置。绝对定位对于创建视觉标注、在图表上叠加图像或插入水印或装饰元素特别有用，无论文本编辑如何，这些元素都应保持静止。

要使用 Python 将绝对定位的图像插入 Word 文档，请遵循以下关键步骤：

创建新的 Document 对象。使用 Document.AddSection 函数添加部分。使用 Section.AddParagraph 函数添加段落。使用 Paragraph.AppendPicture 函数向段落添加图像。设置图像的宽度、高度和文本环绕样式。使用 DocPicture.HorizontalOrigin 和 DocPicture.VerticalOrigin 属性设置图像的水平和垂直原点。使用 DocPicture.HorizontalPosition 和 DocPicture.VerticalPosition 属性设置图像的绝对水平和垂直位置。使用 DocPicture.HorizontalAlignment 和 DocPicture.VerticalAlignment 属性设置图像的水平和垂直对齐方式。使用 Document.SaveToFile 函数将结果保存到文件中。

下面是一个在 Python 中将绝对定位图像插入 Word 文档的简单示例：

from spire.doc import *from spire.doc.common import *try: # Create a Document object document = Document # Add a section section = document.AddSection # Set page margins section.PageSetup.Margins.All = 72.0 # Add a title paragraph to the section title_paragraph = section.AddParagraph # Set text and format for the paragraph text_range = title_paragraph.AppendText("Introduction to Python Programming Language") text_range.CharacterFormat.FontName = "Calibri" text_range.CharacterFormat.TextColor = Color.get_RoyalBlue title_paragraph.ApplyStyle(BuiltinStyle.Heading1) title_paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center title_paragraph.Format.AfterSpacing = 18 # Add a paragraph to the section paragraph = section.AddParagraph # Add an image to the paragraph image = paragraph.AppendPicture("Python.png") # Set image width and height image.Width = 100 image.Height = 100 # Set text wrapping style for the image (note when the text wrapping style is inline, the images are not absolutely positioned) image.TextWrappingStyle = TextWrappingStyle.Square # Set horizontal and vertical origin for the image image.HorizontalOrigin = HorizontalOrigin.Page image.VerticalOrigin = VerticalOrigin.Paragraph # Set absolute horizontal and vertical position for the image image.HorizontalPosition = 200 image.VerticalPosition = 150 # Set horizontal and vertical alignment for the image image.HorizontalAlignment = ShapeHorizontalAlignment.Center image.VerticalAlignment = ShapeVerticalAlignment.Center # Save the document to a file document.SaveToFile("AddAbsolutelyPositionedImage.docx", FileFormat.Docx2019) print("Document saved successfully.") document.Closeexcept Exception as e: print(f"Error processing the document: {e}")

使用 Python 将绝对定位图像添加到 Word

插入图像以显示在 Microsoft Word 文档的每一页上，是在整个内容中建立一致的视觉主题或品牌的有效方法。这种技术通常用于插入应该出现在所有页面上的徽标或其他重复元素。

要使用 Python 将图像插入 Word 文档的每一页，请遵循以下关键步骤：

创建新的 Document 对象。使用 Document.LoadFromFile 函数加载现有 Word 文档。创建一个 FixedLayoutDocument 对象，用于将文档转换为固定布局文档。使用 FixedLayoutDocument.Pages 属性获取文档的页面。遍历页面。对于每个页面，使用 FixedLayoutPage.GetChildEntities 函数获取页面上的特定行，然后使用 FixedLayoutLine.Paragraph 属性获取该行的段落。使用 Paragraph.AppendPicture 函数向段落添加图像。设置图像的宽度、高度、文本环绕样式、水平和垂直原点、位置和对齐方式。使用 Document.SaveToFile 函数将结果保存到文件中。

以下是在 Python 中将图像插入 Word 文档的每一页的简单示例：

from spire.doc import *from spire.doc.common import *try: # Create a Document object document = Document # Load a Word document document.LoadFromFile("AI.docx") # Create an object of the FixedLayoutDocument class to convert the document to a fixed layout document layoutDoc = FixedLayoutDocument(document) # Get the pages of the document pages = layoutDoc.Pages # Iterate through the pages of the document for page_index in range(pages.Count): page = pages[page_index] # Get the lines of the page lines = page.GetChildEntities(LayoutElementType.Line, True) if lines: # Get the paragraph of the first line paragraph = lines[0].Paragraph # Add an image to the paragraph image = paragraph.AppendPicture("Logo2.png") # Set image width and height image.Width = 100 image.Height = 100 # Set text wrapping style for the image image.TextWrappingStyle = TextWrappingStyle.Behind # Set horizontal and vertical origin for the image image.HorizontalOrigin = HorizontalOrigin.Page image.VerticalOrigin = VerticalOrigin.Paragraph # Set absolute horizontal and vertical position for the image image.HorizontalPosition = 200 image.VerticalPosition = 150 # Set horizontal and vertical alignment for the image image.HorizontalAlignment = ShapeHorizontalAlignment.Center image.VerticalAlignment = ShapeVerticalAlignment.Center # Save the document to a file document.SaveToFile("AddImageToEachPage.docx", FileFormat.Docx2019) print("Document saved successfully.") document.Closeexcept Exception as e: print(f"Error processing the document: {e}")