分页符是文档中的一种格式元素，用于表示一页的结束和新页的开始。它通常用一条水平线或其他视觉指示符来表示，将内容分隔成不同的页面。在创建报告、论文或书籍等长篇文档时，通常会使用这一功能来增强整体布局和可读性。在本文中，您将学习如何使用 Spire.Doc for Python 通过代码在 Word 文档中插入分页符。

• 在指定段落后插入分页符
• 在指定文本后插入分页符

安装 Spire.Doc for Python

本教程需要用到 Spire.Doc for Python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 Windows 中。

pip install Spire.Doc

如果您不确定如何安装，请参考：如何在 Windows 中安装 Spire.Doc for Python

在指定段落后插入分页符

Spire.Doc for Python 提供的 Paragraph.AppendBreak(BreakType.PageBreak) 方法可用于在 Word 文档中的指定段落后插入分页符。具体步骤如下：

• 创建 Document 类的对象。
• 使用 Document.LoadFromFile() 方法加载 Word 文件。
• 通过 Document.Sections[sectionIndex] 属性获取该文件的第一节。
• 通过 Section.Paragraphs[paragraphIndex] 属性获取该节中的指定段落。
• 使用 Paragraph.AppendBreak(BreakType.PageBreak) 方法在指定段落后插入分页符。
• 使用 Document.SaveToFile() 方法保存结果文件。

from spire.doc import *
from spire.doc.common import *

inputFile =  "测试.docx"
outputFile = "插入分页符.docx"

# 创建Document对象
document = Document()

# 加载一个Word文档
document.LoadFromFile(inputFile)

# 获取文档第一节
section = document.Sections[0]

# 获取该节中的第二个段落
paragraph = section.Paragraphs[1]

# 在段落后插入分页符
paragraph.AppendBreak(BreakType.PageBreak)

# 保存结果文件
document.SaveToFile(outputFile, FileFormat.Docx2016)
document.Close()

在指定文本后插入分页符

此外，您还可以使用该库提供的 Paragraph.ChildObjects.Insert() 方法在指定文本后插入分页符。具体步骤如下：

• 创建 Document 类的对象。
• 使用 Document.LoadFromFile() 方法加载Word文件。
• 使用 Document.FindAllString() 方法查找特定文本。
• 循环遍历所有查找到的文本，并使用 TextSelection.GetAsOneRange() 方法获取其文本范围。
• 通过 ParagraphBase.OwnerParagraph 属性获取文本范围所在的段落。
• 使用 Paragraph.ChildObjects.IndexOf() 方法获取文本范围在段落中的位置索引。
• 创建 Break 类的对象来创建分页符。
• 使用 Paragraph.ChildObjects.Insert() 方法在查找到的文本后插入分页符。
• 使用 Document.SaveToFile() 方法保存结果文件。

from spire.doc import *
from spire.doc.common import *

inputFile = "测试.docx"
outputFile =  "在文本后插入分页符.docx"

# 创建Document对象
document = Document()

# 加载一个Word文档
document.LoadFromFile(inputFile)

# 查找指定文本
selection = document.FindAllString("内核", True, True)

# 遍历所有查找到的文本
for ts in selection:

    # 获取文本的文本范围
    range = ts.GetAsOneRange()

    # 获取文本范围所在的段落
    paragraph = range.OwnerParagraph

    # 获取段落中文本范围的位置索引
    index = paragraph.ChildObjects.IndexOf(range)

    # 创建Break对象
    pageBreak = Break(document, BreakType.PageBreak)

    # 在查找到的文本后插入分页符
    paragraph.ChildObjects.Insert(index + 1, pageBreak)

# 保存结果文件
document.SaveToFile(outputFile, FileFormat.Docx2016)
document.Close()

申请临时 License

如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。