题注在 Word 文档中起到了标识、解释、导航和辅助功能等作用。它们是创建专业、准确和易于使用的文档的关键元素之一。它们有助于提高文档的可读性、易用性和可访问性，对于理解和有效处理文档内容至关重要。本文将介绍如何使用 Spire.Doc for Python 通过 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
添加图片题注到 Word 文档
Spire.Doc for Python 提供了为图片添加题注的便利的方法，只需调用 DocPicture.AddCaption(self ,name:str,numberingFormat:'CaptionNumberingFormat',captionPosition:'CaptionPosition') 方法即可生成图片题注的编号。详细步骤如下：
- 创建一个 Document 类的对象。
- 使用 Document.AddSection() 方法添加一个章节。
- 创建一个 Paragraph 对象 pictureParagraphCaption 并将其添加到文档中的指定章节（section）。
- 使用 AppendPicture(self ,imgFile:str) 方法向段落中添加 DocPicture 图片对象 pic1。
- 通过 DocPicture.AddCaption(self ,name:str,numberingFormat:'CaptionNumberingFormat',captionPosition:'CaptionPosition') 方法来添加题注以 CaptionNumberingFormat.Number 数字方式进行编号。
- 使用 Document.SaveToFile() 方法保存结果文档。
- Python
from spire.doc import *
from spire.doc.common import *
# 创建Word文档对象
document = Document()
# 添加一个章节
section = document.AddSection()
# 添加一个新段落并给它添加一个图片
pictureParagraphCaption = section.AddParagraph()
pictureParagraphCaption.Format.AfterSpacing = 10
pic1 = pictureParagraphCaption.AppendPicture("Data\\1.png")
pic1.Height = 100
pic1.Width = 100
# 给图片添加题注
format = CaptionNumberingFormat.Number
pic1.AddCaption("图片", format, CaptionPosition.BelowItem)
# 再新添加一个新段落并给它添加一个图片
pictureParagraphCaption = section.AddParagraph()
pic2 = pictureParagraphCaption.AppendPicture("Data\\2.png")
pic2.Height = 100
pic2.Width = 100
# 给图片添加题注
pic2.AddCaption("图片", format, CaptionPosition.BelowItem)
# 更新文档中的所有的域
document.IsUpdateFields = True
# 保存到一个docx文档
result = "添加图片题注.docx"
document.SaveToFile(result, FileFormat.Docx2016)
# 关闭document对象释放资源
document.Close()
document.Dispose()
添加表格题注到 Word 文档
为方便给表格添加题注，Spire.Doc for Python 也提供了类似添加图片题注的便利方法，即调用 Table.AddCaption(self ,name:str,format:'CaptionNumberingFormat',captionPosition:'CaptionPosition') 方法来为表格创建题注的编号。详细步骤如下：
- 创建一个 Document 类的对象。
- 使用 Document.AddSection() 方法添加一个章节。
- 创建一个 Table 对象 tableCaption 并将其添加到文档中的指定章节（section）。
- 使用 Table.ResetCells(self ,rowsNum:int,columnsNum:int) 方法来设置表格的行数和列数。
- 通过 Table.AddCaption(self ,name:str,format:'CaptionNumberingFormat',captionPosition:'CaptionPosition') 方法来添加题注以 CaptionNumberingFormat.Number 数字方式进行编号。
- 使用 Document.SaveToFile() 方法保存结果文档。
- Python
from spire.doc import *
from spire.doc.common import *
# 创建Word文档对象
document = Document()
# 添加一个章节
section = document.AddSection()
# 添加一个表格
tableCaption = section.AddTable(True)
tableCaption.ResetCells(3, 2)
# 给表格添加题注
tableCaption.AddCaption("表格", CaptionNumberingFormat.Number, CaptionPosition.BelowItem)
# 再新添加一个表格并给表格添加题注
tableCaption = section.AddTable(True)
tableCaption.ResetCells(2, 3)
tableCaption.AddCaption("表格", CaptionNumberingFormat.Number, CaptionPosition.BelowItem)
# 更新文档中的所有的域
document.IsUpdateFields = True
# 保存到一个docx文档
result = "添加表格题注.docx"
document.SaveToFile(result, FileFormat.Docx2016)
# 关闭document对象释放资源
document.Close()
document.Dispose()
从 Word 文档中删除题注
Spire.Doc for Python 也支持从 Word 文档中将题注删除。详细步骤如下：
- 创建 Document 类的对象。
- 使用 Document.LoadFromFile() 方法加载一个 Word 文档。
- 创建一个自定义方法 detect_caption_paragraph(paragraph) 来判断此段落是否包含题注。
- 循环遍历文档中所有的段落 Paragraph 对象，并使用自定义方法 detect_caption_paragraph(paragraph) 找出包含题注的段落，将它们全部删除掉。
- 使用 Document.SaveToFile() 方法保存结果文档。
- Python
from spire.doc import *
from spire.doc.common import *
# 判断段落是否为题注段落的方法
def detect_caption_paragraph(paragraph):
tag = False
field = None
# 遍历段落中的子对象
for i in range(len(paragraph.ChildObjects)):
if paragraph.ChildObjects[i].DocumentObjectType == DocumentObjectType.Field:
# 判断子对象是否为Field类型
field = paragraph.ChildObjects[i]
if field.Type == FieldType.FieldSequence:
# 判断Field类型是否为FieldSequence，即题注域类型
return True
return tag
# 创建Word文档对象
document = Document()
# 加载示例.docx文件
document.LoadFromFile("Data/示例.docx")
# 遍历所有节
for i in range(len(document.Sections)):
section = document.Sections.get_Item(i)
# 倒序遍历节中的段落
for j in range(len(section.Body.Paragraphs) - 1, -1, -1):
# 检测段落是否为题注段落
if detect_caption_paragraph(section.Body.Paragraphs[j]):
# 如果是题注段落，则移除该段落
section.Body.Paragraphs.RemoveAt(j)
# 保存删除题注后的文档
result = "删除题注.docx"
document.SaveToFile(result, FileFormat.Docx2016)
# 关闭document对象释放资源
document.Close()
document.Dispose()
申请临时 License
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
