快捷導(dǎo)航

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

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

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

引言

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

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

用Python插入文本框到Word文檔

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

創(chuàng)建Document實例，以新建Word文檔。
使用Document.AddSection()方法在文檔中添加一個節(jié)，并設(shè)置頁面。
使用Section.AddParagraph()方法在節(jié)中添加一個段落，并插入內(nèi)容。
使用Paragraph.AppendTextBox()方法，在段落中添加一個指定尺寸的文本框。
使用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)建文檔對象
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("以下是一個文本框示例：\r\n")
text_range.CharacterFormat.FontName = "微軟雅黑"
text_range.CharacterFormat.FontSize = 14

# 在段落中添加一個文本框
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()

# 添加分隔線
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)容，請仔細閱讀。如需進一步操作，請訪問我們的知識庫或聯(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("機密文件")
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屬性來獲取文檔中的所有文本框，然后使用RemoveAt()方法根據(jù)參數(shù)刪除指定文本框，或直接使用Clear()方法刪除所有文本框。
以下是操作步驟：

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

代碼示例

from spire.doc import Document

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

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

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

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

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

結(jié)果文檔