Spire.Doc for Python：Word文本框的添加、样式设置与删除指南
在Word文档自动化排版中，文本框常用于制作侧边栏、引用标注或独立注释，其定位不受正文流限制。通过Python库Spire.Doc，可以直接操作文本框的创建、样式配置和删除，而无需依赖Microsoft Word。本文基于Spire.Doc for Python，介绍如何在Word文档中实现文本框的自动化管理。pip install Spire.Doc
Spire.Doc提供免费版，适合小型项目或测试。以下从基础添加开始，逐步扩展样式控制与删除操作，并解析常见问题。
一、添加简单文本框
使用段落对象的AppendTextBox方法，可以快速在文档中插入一个文本框。需要指定宽度和高度（单位：磅）。文本框有自己的Body区域，可以像普通段落一样添加文字。
from spire.doc import *
from spire.doc.common import *
doc = Document()
section = doc.AddSection()
para = section.AddParagraph()
para.AppendText("以下是自动生成的文本框：\n\n")
# 添加文本框（宽150磅，高50磅）
textbox = para.AppendTextBox(150.0, 50.0)
# 在文本框中添加段落和文字
tb_para = textbox.Body.AddParagraph()
text_range = tb_para.AppendText("文本框1")
doc.SaveToFile("添加文本框.docx", FileFormat.Docx)
doc.Close()
doc.Dispose()
二、设置文本框样式与位置
默认文本框是嵌入在段落中的。通过Format属性，可以将其设为自由定位，并调整外观。
1. 坐标与定位控制
设置环绕方式为Square，并指定水平和垂直的参考基准（页面或段落），再设定绝对坐标。
textbox.Format.TextWrappingStyle = TextWrappingStyle.Square
textbox.Format.HorizontalOrigin = HorizontalOrigin.Page
textbox.Format.VerticalOrigin = VerticalOrigin.Page
textbox.Format.HorizontalPosition = 100.0
textbox.Format.VerticalPosition = 150.0
2. 外观与填充
可以使用FillColor设置背景色，或通过Filled属性实现透明。边框可用LineColor或LineWidth控制隐藏。
textbox.Format.FillColor = Color.get_LightBlue()# 浅蓝色背景
# 如需全透明：textbox.Format.Filled = False
# 隐藏边框：textbox.Format.LineColor = Color.get_Transparent()
# 或线宽设为0：textbox.Format.LineWidth = 0
三、删除文本框
通过Document对象的TextBoxes集合可以管理所有文本框。RemoveAt(index)删除指定索引的文本框，Clear()清空所有。注意索引顺序与XML树中对象的创建顺序相关，而非视觉排列顺序。
from spire.doc import *
from spire.doc.common import *
inputFile = "F:\\data\\Textbox.docx"
outputFile = "移除文本框.docx"
doc = Document()
doc.LoadFromFile(inputFile)
# 删除第一个文本框
doc.TextBoxes.RemoveAt(0)
# 清空所有文本框（取消注释下一行）
# doc.TextBoxes.Clear()
doc.SaveToFile(outputFile, FileFormat.Docx)
doc.Close()
doc.Dispose()
四、常见问题与解答
1. 索引与视觉顺序不一致
调用RemoveAt删除指定的文本框时，可能发现删除的不是预期位置的对象，因为索引按创建顺序（或段落绑定顺序）排列，而非页面坐标。解决方法：遍历TextBoxes集合，检查textbox.Body.Text内容来定位目标对象。
for i in range(doc.TextBoxes.Count):
tb = doc.TextBoxes.get_Item(i)
if tb.Body.Text == "目标文字":
doc.TextBoxes.RemoveAt(i)
break
2. 文本框内容溢出
文本框的宽高固定，写入过长文本时，超出的部分会被隐藏。如果内容长度不可控，建议分段写入多个段落，或在创建时预留更大的尺寸。
总结
本文演示了使用Spire.Doc for Python添加、样式设置和删除Word文本框的完整流程。掌握这些操作后，可以高效实现文档自动化排版中的文本框管理，避免手动调整的繁琐。实际项目中，结合文件遍历和条件判断，能够批量处理大量模板文档。
Re: Spire.Doc for Python：Word文本框的添加、样式设置与删除指南
很实用，感谢分享！尤其是删除文本框时索引与视觉顺序不一致的问题，我之前踩过这个坑，用遍历文本内容定位确实是个靠谱的办法。另外想问下，文本框内文字的对齐方式（比如居中）能通过Spire.Doc设置吗？或者有没有办法让文本框根据内容自动调整高度？如果教程里能补充这部分就更好了。Re: Spire.Doc for Python：Word文本框的添加、样式设置与删除指南
感谢楼主分享！这篇教程非常实用，Spire.Doc for Python直接操作文本框确实比用VBA或手动调整高效多了。 我有个小问题想请教：在添加文本框时，如果希望文本框内包含多段文字（比如分标题和正文），是否需要在 `tb_para` 之后继续添加多个段落？我看到示例里只用了一个 `AddParagraph`，如果是多个段落，是不是每次都要重新获取 `textbox.Body` 再 `AddParagraph`？另外，文本框内文字的字号、颜色等格式可以直接通过 `text_range` 的相应属性设置吗？ 还有一点想确认：免费版Spire.Doc对于文本框操作有没有数量或文件页数限制？实际项目中如果处理大量文档，会不会有性能瓶颈？ 希望楼主有空时能再展开讲讲文本框内文字样式的详细设置，期待后续教程！Re: Spire.Doc for Python：Word文本框的添加、样式设置与删除指南
非常实用的教程！Spire.Doc 操作文本框的流程写得很清晰，尤其是索引与视觉顺序不一致的坑，用文字内容来定位确实能避免误删。另外，关于文本框内容溢出的提醒也很到位，省得后面踩坑。感谢分享！
页:
[1]