在现代文档自动化场景中,内容控件(Content Controls)提供了一种结构化的方式来创建交互式 Word 文档。内容控件允许开发者在文档中嵌入下拉列表、日期选择器、文本输入框等交互元素,从而构建表单模板、调查问卷或标准化文档。

本文将介绍如何使用 Python 和 Spire.Doc 库在 Word 文档中以编程方式添加和管理多种类型的内容控件,包括组合框、文本框、图片控件、日期选择器和下拉列表。

首先,需要安装 Spire.Doc for Python 库:

Spire.Doc 是一个功能丰富的 Word 文档处理库,支持在不安装 Microsoft Word 的情况下创建、读取、编辑和转换 Word 文档。

内容控件(也称为结构化文档标签,Structured Document Tags - SDT)是 Word 文档中的容器元素,用于定义文档中特定类型内容的区域。它们提供了以下优势:

组合框允许用户从预定义的列表中选择一项,也可以手动输入自定义值。这在需要标准化输入的场景中非常有用,例如选择产品名称、部门或类别。

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

# 创建文档对象
document = Document()
section = document.AddSection()

# 添加说明文本
paragraph = section.AddParagraph()
txtRange = paragraph.AppendText("添加组合框内容控件：")
txtRange.CharacterFormat.Italic = True

# 创建结构化文档标签
sd = StructureDocumentTagInline(document)
paragraph.ChildObjects.Add(sd)

# 设置控件类型为组合框
sd.SDTProperties.SDTType = SdtType.ComboBox

# 创建组合框并添加选项
cb = SdtComboBox()
cb.ListItems.Add(SdtListItem("Spire.Doc"))
cb.ListItems.Add(SdtListItem("Spire.XLS"))
cb.ListItems.Add(SdtListItem("Spire.PDF"))

# 应用控件属性
sd.SDTProperties.ControlProperties = cb

# 设置默认显示值
rt = TextRange(document)
rt.Text = cb.ListItems[0].DisplayText
sd.SDTContent.ChildObjects.Add(rt)

# 保存文档
document.SaveToFile("ComboBoxControl.docx", FileFormat.Docx)
document.Close()


 类用于创建内联的内容控件。通过设置 

 对象用于管理列表项,可以动态添加或删除选项。

纯文本控件允许用户输入多行文本,适用于地址、备注或描述等自由文本字段。

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

document = Document()
section = document.AddSection()

# 添加说明
paragraph = section.AddParagraph()
txtRange = paragraph.AppendText("添加文本内容控件：")
txtRange.CharacterFormat.Italic = True

# 创建文本控件
sd = StructureDocumentTagInline(document)
paragraph.ChildObjects.Add(sd)
sd.SDTProperties.SDTType = SdtType.Text

# 配置文本属性,允许多行输入
text = SdtText(True)
text.IsMultiline = True
sd.SDTProperties.ControlProperties = text

# 设置占位符文本
rt = TextRange(document)
rt.Text = "请输入文本内容..."
sd.SDTContent.ChildObjects.Add(rt)

document.SaveToFile("TextControl.docx", FileFormat.Docx)
document.Close()


 构造函数接受一个布尔参数,用于指定是否允许多行输入。当设置为 

 时,用户可以输入包含换行符的长文本。

图片控件允许用户在文档中插入和管理图像,适用于需要动态添加产品图片、徽标或签名的场景。

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

document = Document()
section = document.AddSection()

paragraph = section.AddParagraph()
txtRange = paragraph.AppendText("添加图片内容控件：")
txtRange.CharacterFormat.Italic = True

# 创建图片控件
sd = StructureDocumentTagInline(document)
paragraph.ChildObjects.Add(sd)
sd.SDTProperties.SDTType = SdtType.Picture

# 加载并添加图片
pic = DocPicture(document)
pic.Width = 100
pic.Height = 100
pic.LoadImage("./Data/logo.png")
sd.SDTContent.ChildObjects.Add(pic)

document.SaveToFile("PictureControl.docx", FileFormat.Docx)
document.Close()


图片控件会自动处理图像的缩放和布局,用户可以通过控件界面替换或移除图片。

日期选择器提供日历界面,让用户以标准化格式选择日期,避免日期格式不一致的问题。

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

document = Document()
section = document.AddSection()

paragraph = section.AddParagraph()
txtRange = paragraph.AppendText("添加日期选择器内容控件：")
txtRange.CharacterFormat.Italic = True

# 创建日期选择器
sd = StructureDocumentTagInline(document)
paragraph.ChildObjects.Add(sd)
sd.SDTProperties.SDTType = SdtType.DatePicker

# 配置日期格式和日历类型
date = SdtDate()
date.CalendarType = CalendarType.Default
date.DateFormat = "yyyy.MM.dd"
date.FullDate = DateTime.get_Now()
sd.SDTProperties.ControlProperties = date

# 设置默认日期
rt = TextRange(document)
rt.Text = "2024.01.15"
sd.SDTContent.ChildObjects.Add(rt)

document.SaveToFile("DatePickerControl.docx", FileFormat.Docx)
document.Close()


 对象允许自定义日期格式字符串,支持各种常见的日期表示方式,如 "yyyy-MM-dd"、"MM/dd/yyyy" 等。

与组合框不同,下拉列表只允许用户从预定义选项中选择,不允许手动输入。这适用于需要严格限制输入值的场景。

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

document = Document()
section = document.AddSection()

paragraph = section.AddParagraph()
txtRange = paragraph.AppendText("添加下拉列表内容控件:")
txtRange.CharacterFormat.Italic = True

# 创建下拉列表
sd = StructureDocumentTagInline(document)
paragraph.ChildObjects.Add(sd)
sd.SDTProperties.SDTType = SdtType.DropDownList

# 添加列表项
sddl = SdtDropDownList()
sddl.ListItems.Add(SdtListItem("Harry"))
sddl.ListItems.Add(SdtListItem("Jerry"))
sddl.ListItems.Add(SdtListItem("Tom"))
sd.SDTProperties.ControlProperties = sddl

# 设置默认选项
rt = TextRange(document)
rt.Text = sddl.ListItems[0].DisplayText
sd.SDTContent.ChildObjects.Add(rt)

document.SaveToFile("DropDownListControl.docx", FileFormat.Docx)
document.Close()


为防止用户修改内容控件的结构,可以锁定控件:

# 锁定控件,防止删除或修改
sd.SDTProperties.LockContents = True
sd.SDTProperties.LockControl = True


# 设置控件颜色
sd.SDTProperties.Color = Color.get_LightBlue()

# 设置显示外观
sd.SDTProperties.Appearance = SdtAppearance.BoundingBox


从现有文档中提取内容控件的值:

# 遍历文档中的所有内容控件
for sdt in document.GetChildObjects(True, ObjectType.StructureDocumentTagInline):
    tag = sdt if isinstance(sdt, StructureDocumentTagInline) else None
    if tag:
        # 获取控件类型
        control_type = tag.SDTProperties.SDTType
        # 获取控件内容
        content = tag.SDTContent.Text
        print(f"类型:{control_type}, 内容:{content}")


内容控件为 Word 文档自动化提供了强大的交互能力。通过 Python 和 Spire.Doc 库,我们可以以编程方式创建和管理各种类型的内容控件,包括:

这些控件特别适用于创建表单模板、合同文档、调查问卷和标准化报告。通过合理组合不同类型的内容控件,可以构建出既美观又实用的交互式 Word 文档,大幅提升文档处理的效率和准确性。

在实际项目中,建议根据具体需求选择合适的控件类型,并考虑添加数据验证逻辑以确保输入质量。同时,合理的控件布局和清晰的标签说明也能显著提升用户体验。

Python 实现 Word 内容控件管理

编程语言

开发工具

后端

学习使用Python和Spire.Doc库在Word文档中添加交互式内容控件，包括组合框、文本框、图片控件、日期选择器和下拉列表。这些控件能创建标准化表单、调查问卷和自动化文档，提升文档处理效率和数据准确性。

结构化数据

容器

Python

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Python 实现 Word 内容控件管理

Python 实现 Word 内容控件管理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐