在 word 中创建用户可填写的表单可以提供一种便捷的电子数据采集方式,这尤其适用于需要收集用户信息、反馈或者需要创建交互式文档的场景。通过添加文本字段、复选框、下拉菜单等各种元素,您可以根据具体需求创建适合自己的定制表单。
要在 word 中创建可填写的表单,可能需要使用以下工具。
- 内容控件:内容控件是 word 中用于收集用户输入的区域。
- 表格:表格在表单中用于对齐文本和表单字段,并创建可视化的边框和方框。
- 保护:通过保护文档,您可以允许用户填充表单字段,但限制对文档其他部分的更改。
在 word 中,内容控件可以充当结构化文档的容器,允许用户组织和管理文档内容。word 2013 提供了十种类型的内容控件。本文将介绍如何使用 spire.doc for python 在 word 中创建包含以下七种常用内容控件的可填写表单。
内容控件 | 描述 |
纯文本 | 仅限于纯文本的控件,不包含任何格式。 |
格式文本 | 除了格式化文本外,还可以包含其他内容(例如,图片)和其他内容控件(例如,下拉列表)的控件。 |
图片 | 只能包含图片的控件。 |
下拉列表 | 可在一个框中为用户提供一个选项列表的控件,用户只能从选项列表中进行选择。 |
组合框 | 可在一个框中为用户提供一个选项列表的控件,用户既可以从选项列表中进行选择,也可以在框中键入自己的信息。 |
复选框 | 允许用户在一个小方框中通过添加或删除复选标记来做出选择的控件:是(选中)或否(未选中)。 |
日期选取器 | 包含一个日历的控件,用户可从中选择一个日期。 |
安装 spire.doc for python
本教程需要用到 spire.doc for python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 vs code 中。
pip install spire.doc
如果您不确定如何安装,请参考:如何在 vs code 中安装 spire.doc for python
python 在 word 中创建可填写表单
spire.doc for python 提供的 structuredocumenttaginline 类,用于在段落中生成结构化文档标记。利用该类的 sdtproperties 属性和 sdtcontent 属性,可以定义当前结构化文档标签的属性和内容。
以下是使用 python 在 word 文档中创建可填充表单的详细步骤:
- 创建 document 类的对象。
- 使用 document.addsection() 方法添加一个章节。
- 使用 section.addtable() 方法添加表格。
- 使用 tablecell.addparagraph() 方法在特定表格单元格中添加段落。
- 创建 structuredocumenttaginline 类的实例,并使用 paragraph.childobjects.add() 方法将其作为子对象添加到段落中。
- 通过 structuredocumenttaginline 对象的 sdtproperties 属性和 sdtcontent 属性指定结构化文档标记的类型、内容和其他属性。
- 使用 document.protect() 方法防止用户编辑表单字段以外的内容。
- 使用 document.savetofile() 方法保存文档。
- python
from spire.doc import *
from spire.doc.common import *
# 创建document对象
doc = document()
# 添加一节
section = doc.addsection()
# 添加一个表格
table = section.addtable(true)
table.resetcells(7, 2)
table.setcolumnwidth(0, 120, cellwidthtype.point)
table.setcolumnwidth(1, 350, cellwidthtype.point)
# 在第一列的单元格中添加文本
paragraph = table.rows[0].cells[0].addparagraph()
paragraph.appendtext("名字")
paragraph = table.rows[1].cells[0].addparagraph()
paragraph.appendtext("信息")
paragraph = table.rows[2].cells[0].addparagraph()
paragraph.appendtext("照片")
paragraph = table.rows[3].cells[0].addparagraph()
paragraph.appendtext("国家")
paragraph = table.rows[4].cells[0].addparagraph()
paragraph.appendtext("爱好")
paragraph = table.rows[5].cells[0].addparagraph()
paragraph.appendtext("生日")
paragraph = table.rows[6].cells[0].addparagraph()
paragraph.appendtext("性别")
# 在单元格(0,1)中添加纯文本内容控件
paragraph = table.rows[0].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.text
sdt.sdtproperties.alias = "纯文本内容控件"
sdt.sdtproperties.tag = "纯文本内容控件"
sdt.sdtproperties.isshowingplaceholder = true
text = sdttext(true)
text.ismultiline = false
sdt.sdtproperties.controlproperties = text
textrange = textrange(doc)
textrange.text = "请填写姓名"
sdt.sdtcontent.childobjects.add(textrange)
# 在单元格(1,1)中添加格式文本内容控件
paragraph = table.rows[1].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.richtext
sdt.sdtproperties.alias = "格式文本内容控件"
sdt.sdtproperties.tag = "格式文本内容控件"
sdt.sdtproperties.isshowingplaceholder = true
text = sdttext(true)
text.ismultiline = false
sdt.sdtproperties.controlproperties = text
textrange = textrange(doc)
textrange.text = "自我简介"
sdt.sdtcontent.childobjects.add(textrange )
# 在单元格(2,1)中添加图片内容控件
paragraph = table.rows[2].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.picture
sdt.sdtproperties.alias = "图片内容控件"
sdt.sdtproperties.tag = "图片内容控件"
sdtpicture = sdtpicture(true)
sdt.sdtproperties.controlproperties = sdtpicture
pic = docpicture(doc)
pic.loadimage("上传.jpg")
sdt.sdtcontent.childobjects.add(pic)
# 在单元格 (3,1) 中添加下拉列表内容控件
paragraph = table.rows[3].cells[1].addparagraph();
sdt = structuredocumenttaginline(doc)
sdt.sdtproperties.sdttype = sdttype.dropdownlist
sdt.sdtproperties.alias = "下拉列表内容控件"
sdt.sdtproperties.tag = "下拉列表内容控件"
paragraph.childobjects.add(sdt)
stdlist = sdtdropdownlist()
stdlist.listitems.add(sdtlistitem("中国", "1"))
stdlist.listitems.add(sdtlistitem("美国", "2"))
stdlist.listitems.add(sdtlistitem("英国", "3"))
stdlist.listitems.add(sdtlistitem("法国", "4"))
sdt.sdtproperties.controlproperties = stdlist;
textrange = textrange(doc)
textrange .text = stdlist.listitems[0].displaytext
sdt.sdtcontent.childobjects.add(textrange )
# 在单元格 (4,1) 中添加两个复选框内容控件
paragraph = table.rows[4].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.checkbox
sdtcheckbox = sdtcheckbox()
sdt.sdtproperties.controlproperties = sdtcheckbox
textrange = textrange(doc)
sdt.childobjects.add(textrange)
sdtcheckbox.checked = false
paragraph.appendtext(" 电影")
paragraph = table.rows[4].cells[1].addparagraph();
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.checkbox
sdtcheckbox = sdtcheckbox()
sdt.sdtproperties.controlproperties = sdtcheckbox
textrange = textrange(doc)
sdt.childobjects.add(textrange)
sdtcheckbox.checked = false
paragraph.appendtext(" 游戏")
# 在单元格 (5,1) 中添加日期选择器内容控件
paragraph = table.rows[5].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.datepicker
sdt.sdtproperties.alias = "日期选取器内容控件"
sdt.sdtproperties.tag = "日期选取器内容控件"
stddate = sdtdate()
stddate.calendartype = calendartype.default
stddate.dateformat = "yyyy.mm.dd"
stddate.fulldate = datetime.get_now()
sdt.sdtproperties.controlproperties = stddate
textrange = textrange(doc)
textrange.text = "你的出生日期"
sdt.sdtcontent.childobjects.add(textrange)
# 在单元格 (6,1) 中添加组合框内容控件
paragraph = table.rows[6].cells[1].addparagraph()
sdt = structuredocumenttaginline(doc)
paragraph.childobjects.add(sdt)
sdt.sdtproperties.sdttype = sdttype.combobox
sdt.sdtproperties.alias = "组合框内容控件"
sdt.sdtproperties.tag = "组合框内容控件"
stdcombobox = sdtcombobox()
stdcombobox.listitems.add(sdtlistitem("男性"))
stdcombobox.listitems.add(sdtlistitem("女性"))
sdt.sdtproperties.controlproperties = stdcombobox
textrange = textrange(doc)
textrange.text = stdcombobox.listitems[0].displaytext
sdt.sdtcontent.childobjects.add(textrange)
# 仅允许用户编辑表格字段
doc.protect(protectiontype.allowonlyformfields, "123abc")
# 保存结果文件
doc.savetofile("word表单.docx", fileformat.docx2013)
申请临时 license
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。