Spire.Doc for Python：Word文本框的添加、样式设置与删除指南

脚本专家

在Word文档自动化排版中，文本框常用于制作侧边栏、引用标注或独立注释，其定位不受正文流限制。通过Python库Spire.Doc，可以直接操作文本框的创建、样式配置和删除，而无需依赖Microsoft Word。本文基于Spire.Doc for Python，介绍如何在Word文档中实现文本框的自动化管理。

2. pip install Spire.Doc

复制代码

Spire.Doc提供免费版，适合小型项目或测试。以下从基础添加开始，逐步扩展样式控制与删除操作，并解析常见问题。

一、添加简单文本框

使用段落对象的AppendTextBox方法，可以快速在文档中插入一个文本框。需要指定宽度和高度（单位：磅）。文本框有自己的Body区域，可以像普通段落一样添加文字。

2. from spire.doc import *
3. from spire.doc.common import *
5. doc = Document()
6. section = doc.AddSection()
7. para = section.AddParagraph()
8. para.AppendText("以下是自动生成的文本框：\n\n")
10. # 添加文本框（宽150磅，高50磅）
11. textbox = para.AppendTextBox(150.0, 50.0)
12. # 在文本框中添加段落和文字
13. tb_para = textbox.Body.AddParagraph()
14. text_range = tb_para.AppendText("文本框1")
16. doc.SaveToFile("添加文本框.docx", FileFormat.Docx)
17. doc.Close()
18. doc.Dispose()

复制代码

二、设置文本框样式与位置

默认文本框是嵌入在段落中的。通过Format属性，可以将其设为自由定位，并调整外观。

1. 坐标与定位控制

设置环绕方式为Square，并指定水平和垂直的参考基准（页面或段落），再设定绝对坐标。

2. textbox.Format.TextWrappingStyle = TextWrappingStyle.Square
3. textbox.Format.HorizontalOrigin = HorizontalOrigin.Page
4. textbox.Format.VerticalOrigin = VerticalOrigin.Page
5. textbox.Format.HorizontalPosition = 100.0
6. textbox.Format.VerticalPosition = 150.0

复制代码

2. 外观与填充

可以使用FillColor设置背景色，或通过Filled属性实现透明。边框可用LineColor或LineWidth控制隐藏。

2. textbox.Format.FillColor = Color.get_LightBlue()  # 浅蓝色背景
3. # 如需全透明：textbox.Format.Filled = False
4. # 隐藏边框：textbox.Format.LineColor = Color.get_Transparent()
5. # 或线宽设为0：textbox.Format.LineWidth = 0

复制代码

三、删除文本框

通过Document对象的TextBoxes集合可以管理所有文本框。RemoveAt(index)删除指定索引的文本框，Clear()清空所有。注意索引顺序与XML树中对象的创建顺序相关，而非视觉排列顺序。

2. from spire.doc import *
3. from spire.doc.common import *
5. inputFile = "F:\\data\\Textbox.docx"
6. outputFile = "移除文本框.docx"
8. doc = Document()
9. doc.LoadFromFile(inputFile)
11. # 删除第一个文本框
12. doc.TextBoxes.RemoveAt(0)
14. # 清空所有文本框（取消注释下一行）
15. # doc.TextBoxes.Clear()
17. doc.SaveToFile(outputFile, FileFormat.Docx)
18. doc.Close()
19. doc.Dispose()

复制代码

四、常见问题与解答

1. 索引与视觉顺序不一致

调用RemoveAt删除指定的文本框时，可能发现删除的不是预期位置的对象，因为索引按创建顺序（或段落绑定顺序）排列，而非页面坐标。解决方法：遍历TextBoxes集合，检查textbox.Body.Text内容来定位目标对象。

2. for i in range(doc.TextBoxes.Count):
3.     tb = doc.TextBoxes.get_Item(i)
4.     if tb.Body.Text == "目标文字":
5.         doc.TextBoxes.RemoveAt(i)
6.         break

复制代码

2. 文本框内容溢出

文本框的宽高固定，写入过长文本时，超出的部分会被隐藏。如果内容长度不可控，建议分段写入多个段落，或在创建时预留更大的尺寸。

总结

本文演示了使用Spire.Doc for Python添加、样式设置和删除Word文本框的完整流程。掌握这些操作后，可以高效实现文档自动化排版中的文本框管理，避免手动调整的繁琐。实际项目中，结合文件遍历和条件判断，能够批量处理大量模板文档。

热心网友1

很实用，感谢分享！尤其是删除文本框时索引与视觉顺序不一致的问题，我之前踩过这个坑，用遍历文本内容定位确实是个靠谱的办法。另外想问下，文本框内文字的对齐方式（比如居中）能通过Spire.Doc设置吗？或者有没有办法让文本框根据内容自动调整高度？如果教程里能补充这部分就更好了。

热心网友1

感谢楼主分享！这篇教程非常实用，Spire.Doc for Python直接操作文本框确实比用VBA或手动调整高效多了。 我有个小问题想请教：在添加文本框时，如果希望文本框内包含多段文字（比如分标题和正文），是否需要在 `tb_para` 之后继续添加多个段落？我看到示例里只用了一个 `AddParagraph`，如果是多个段落，是不是每次都要重新获取 `textbox.Body` 再 `AddParagraph`？另外，文本框内文字的字号、颜色等格式可以直接通过 `text_range` 的相应属性设置吗？ 还有一点想确认：免费版Spire.Doc对于文本框操作有没有数量或文件页数限制？实际项目中如果处理大量文档，会不会有性能瓶颈？ 希望楼主有空时能再展开讲讲文本框内文字样式的详细设置，期待后续教程！

热心网友1

非常实用的教程！Spire.Doc 操作文本框的流程写得很清晰，尤其是索引与视觉顺序不一致的坑，用文字内容来定位确实能避免误删。另外，关于文本框内容溢出的提醒也很到位，省得后面踩坑。感谢分享！