快捷導(dǎo)航

使用Python在Word文檔中插入和刪除文本框

更新時(shí)間：2025年04月14日 08:43:30 作者：Eiceblue

在當(dāng)今自動(dòng)化辦公需求日益增長(zhǎng)的背景下,通過(guò)編程手段動(dòng)態(tài)管理Word文檔中的文本框元素已成為提升工作效率的關(guān)鍵技術(shù)路徑,本文將介紹如何使用Python在Word文檔中插入和刪除文本框,需要的朋友可以參考下

引言

在當(dāng)今自動(dòng)化辦公需求日益增長(zhǎng)的背景下，通過(guò)編程手段動(dòng)態(tài)管理Word文檔中的文本框元素已成為提升工作效率的關(guān)鍵技術(shù)路徑。文本框作為文檔排版中靈活的內(nèi)容容器，既能承載多模態(tài)信息（如文字、圖像），又可實(shí)現(xiàn)獨(dú)立于正文流的位置調(diào)整與樣式定制，但其手動(dòng)操作存在重復(fù)性高、批量處理困難等痛點(diǎn)。通過(guò)Python腳本對(duì)文本框進(jìn)行精準(zhǔn)控制，不僅能夠?qū)崿F(xiàn)跨文檔的批量插入與刪除操作，還能將復(fù)雜布局設(shè)計(jì)與數(shù)據(jù)動(dòng)態(tài)綁定，例如自動(dòng)生成報(bào)告模板、標(biāo)準(zhǔn)化企業(yè)文檔格式或構(gòu)建交互式內(nèi)容系統(tǒng)。本文將介紹如何使用Python在Word文檔中插入和刪除文本框。

本文所使用的方法需要用到Free Spire.Doc for Python，PyPI：pip install spire.doc.free。

用Python插入文本框到Word文檔

我們可以使用庫(kù)中提供的Workbook類(lèi)來(lái)創(chuàng)建或載入Word文檔，然后使用Paragraph.AppendTextBox(width: float, height: float)方法在段落中添加任意尺寸的文本框。其中，TextBox.Format屬性可對(duì)文本框格式進(jìn)行設(shè)置，同時(shí)我們可以在文本框中添加文本、圖片等元素。
以下是操作步驟：

創(chuàng)建Document實(shí)例，以新建Word文檔。
使用Document.AddSection()方法在文檔中添加一個(gè)節(jié)，并設(shè)置頁(yè)面。
使用Section.AddParagraph()方法在節(jié)中添加一個(gè)段落，并插入內(nèi)容。
使用Paragraph.AppendTextBox()方法，在段落中添加一個(gè)指定尺寸的文本框。
使用TextBox.Format下的屬性設(shè)置文本框格式。
使用TextBox.Body.AddParagraph()方法在文本框中添加段落。
在文本框段落中添加內(nèi)容并設(shè)置格式。
使用Document.SaveToFile()方法保存Word文檔。

代碼示例

from spire.doc import Document, VerticalOrigin, TextWrappingStyle, HorizontalOrigin, BackgroundType, Color, TextBoxLineStyle, LineDashing, HorizontalAlignment, FileFormat

# 創(chuàng)建文檔對(duì)象
document = Document()

# 添加節(jié)
section = document.AddSection()
section.PageSetup.Margins.Top = 50
section.PageSetup.Margins.Bottom = 50
# 添加段落
main_paragraph = section.AddParagraph()
text_range = main_paragraph.AppendText("以下是一個(gè)文本框示例：\r\n")
text_range.CharacterFormat.FontName = "微軟雅黑"
text_range.CharacterFormat.FontSize = 14

# 在段落中添加一個(gè)文本框
textbox = main_paragraph.AppendTextBox(300, 200)  # 設(shè)置文本框尺寸

# 設(shè)置文本框位置和環(huán)繞樣式
textbox.Format.HorizontalOrigin = HorizontalOrigin.Page
textbox.Format.HorizontalPosition = 50
textbox.Format.VerticalOrigin = VerticalOrigin.Page
textbox.Format.VerticalPosition = 80
textbox.Format.TextWrap = TextWrappingStyle.InFrontOfText

# 設(shè)置漸變背景填充
textbox.Format.FillEfects.Type = BackgroundType.Gradient
textbox.Format.FillEfects.Gradient.Color1 = Color.get_BlueViolet()
textbox.Format.FillEfects.Gradient.Color2 = Color.get_LightSkyBlue()
textbox.Format.FillEfects.Gradient.Angle = 45

# 設(shè)置三維邊框樣式
textbox.Format.LineColor = Color.get_DarkBlue()
textbox.Format.LineStyle = TextBoxLineStyle.ThickThin
textbox.Format.LineWidth = 3.5
textbox.Format.LineDashing = LineDashing.DashDot

# 在文本框內(nèi)添加帶圖標(biāo)的標(biāo)題段落
header_paragraph = textbox.Body.AddParagraph()
icon = header_paragraph.AppendPicture("alert.png")
icon.Width = 20
icon.Height = 20

title_text = header_paragraph.AppendText(" 重要通知")
title_text.CharacterFormat.FontName = "微軟雅黑"
title_text.CharacterFormat.FontSize = 14
title_text.CharacterFormat.TextColor = Color.get_Gold()

# 添加分隔線(xiàn)
separator = textbox.Body.AddParagraph()
separator.Format.Borders.Top.Color = Color.get_Gold()
separator.Format.Borders.Top.LineWidth = 2
separator.Format.Borders.Top.Space = 5

# 添加圖文混排內(nèi)容
content_paragraph = textbox.Body.AddParagraph()
image = content_paragraph.AppendPicture("document.png")
image.Width = 60
image.Height = 60
image.TextWrappingStyle = TextWrappingStyle.Through

text_content = content_paragraph.AppendText("本通知包含重要更新內(nèi)容，請(qǐng)仔細(xì)閱讀。如需進(jìn)一步操作，請(qǐng)?jiān)L問(wèn)我們的知識(shí)庫(kù)或聯(lián)系技術(shù)支持。")
text_content.CharacterFormat.FontName = "黑體"
text_content.CharacterFormat.FontSize = 12
text_content.CharacterFormat.TextColor = Color.get_WhiteSmoke()

# 添加旋轉(zhuǎn)文字裝飾
rotated_paragraph = textbox.Body.AddParagraph()
rotated_text = rotated_paragraph.AppendText("機(jī)密文件")
rotated_text.CharacterFormat.FontName = "HarmonyOS Sans SC"
rotated_text.CharacterFormat.FontSize = 24
rotated_text.CharacterFormat.TextColor = Color.FromArgb(100, 255, 255, 255)
rotated_paragraph.Format.Rotation = 30  # 30度旋轉(zhuǎn)
rotated_paragraph.Format.HorizontalAlignment = HorizontalAlignment.Right

# 保存文檔
document.SaveToFile("output/TextBox.docx", FileFormat.Docx2019)
document.Close()

結(jié)果文檔

用Python刪除Word文檔中的文本框

我們可以用Document.TextBoxes屬性來(lái)獲取文檔中的所有文本框，然后使用RemoveAt()方法根據(jù)參數(shù)刪除指定文本框，或直接使用Clear()方法刪除所有文本框。
以下是操作步驟：

創(chuàng)建Document對(duì)象，使用Document.LoadFromFile()方法載入Word文檔。
使用Document.TextBoxes獲取文檔中的所有文本框。
使用TextBoxCollection.RemoveAt()方法刪除指定文本框，或使用TextBoxCollection.Clear()方法刪除所有文本框。
使用Document.SaveToFile()方法保存Word文檔。

代碼示例

from spire.doc import Document

# 創(chuàng)建Document對(duì)象
document = Document()

# 載入Word文檔
document.LoadFromFile("output/TextBox.docx")

# 刪除指定文本框
document.TextBoxes.RemoveAt(0)

# 刪除所有文本框
document.TextBoxes.Clear()

# 保存文檔
document.SaveToFile("output/RemoveTextBox.docx")
document.Close()

結(jié)果文檔