文本框是 Word 文檔中一種常用的排版元素，它允許用戶在頁(yè)面任意位置放置獨(dú)立于正文流向的文字內(nèi)容，常用于制作側(cè)邊注釋、提示信息、流程圖說(shuō)明以及各類創(chuàng)意排版。在手動(dòng)編輯場(chǎng)景下，插入和調(diào)整文本框并不復(fù)雜，但當(dāng)需要批量生成模板、統(tǒng)一修改格式或清理文檔中的冗余文本框時(shí)，逐個(gè)操作既耗時(shí)又容易出錯(cuò)。通過(guò) Python 編程方式控制文本框的增刪改，可以顯著提升處理效率，并保證文檔格式的一致性。本文將介紹如何使用 Python 在 Word 文檔中添加帶格式的文本框、設(shè)置文本框的位置與樣式，以及刪除文檔中已有的文本框。

環(huán)境準(zhǔn)備

本文使用 Spire.Doc for Python 庫(kù)來(lái)操作 Word 文檔。該庫(kù)提供了完整的文檔處理 API，包括文本框的創(chuàng)建、格式化、內(nèi)容填充和刪除等功能。通過(guò)以下命令安裝：

pip install Spire.Doc

安裝完成后，在腳本中導(dǎo)入所需模塊即可開(kāi)始使用。

from spire.doc import *
from spire.doc.common import *

添加文本框

在 Word 文檔中添加文本框的核心思路是：創(chuàng)建 Document 對(duì)象并添加節(jié)（Section），然后在指定段落上調(diào)用 AppendTextBox() 方法插入文本框。該方法接收寬度和高度兩個(gè)參數(shù)，返回一個(gè) TextBox 對(duì)象，通過(guò)該對(duì)象可以進(jìn)一步設(shè)置文本框的格式屬性和內(nèi)部?jī)?nèi)容。文本框本身只是一個(gè)容器，需要通過(guò) Body.AddParagraph() 在其中添加段落后才能寫(xiě)入文字。

from spire.doc import *
from spire.doc.common import *

outputFile = "AddTextbox.docx"

# 創(chuàng)建文檔并添加節(jié)
document = Document()
section = document.AddSection()
paragraph = section.AddParagraph()

# 插入文本框（寬度 240，高度 35）
textBox = paragraph.AppendTextBox(240, 35)
textBox.Format.HorizontalAlignment = ShapeHorizontalAlignment.Left
textBox.Format.LineColor = Color.get_Gray()
textBox.Format.LineStyle = TextBoxLineStyle.Simple
textBox.Format.FillColor = Color.get_DarkSeaGreen()

# 在文本框中添加文字
para = textBox.Body.AddParagraph()
textRange = para.AppendText("這是一個(gè)示例文本框")
textRange.CharacterFormat.FontName = "宋體"
textRange.CharacterFormat.FontSize = 14
textRange.CharacterFormat.TextColor = Color.get_White()
para.Format.HorizontalAlignment = HorizontalAlignment.Center

document.SaveToFile(outputFile, FileFormat.Docx)
document.Close()

上述代碼中，AppendTextBox(240, 35) 的兩個(gè)參數(shù)分別指定文本框的寬度和高度（單位為磅）。Format 屬性提供了豐富的外觀控制選項(xiàng)：LineColor 設(shè)置邊框顏色，LineStyle 設(shè)置邊框樣式（如 Simple、Double、Triple 等），FillColor 設(shè)置填充背景色。文本框內(nèi)部的文字通過(guò) TextRange 對(duì)象的 CharacterFormat 進(jìn)行字體、字號(hào)和顏色設(shè)置，與普通段落中的文字格式化方式完全一致。這種設(shè)計(jì)使得文本框既具有獨(dú)立的位置和外觀，又能復(fù)用 Spire.Doc 的文字處理能力。

設(shè)置文本框的位置與內(nèi)邊距

默認(rèn)情況下，文本框會(huì)跟隨所在段落的位置排列。當(dāng)需要將文本框精確定位到頁(yè)面的指定坐標(biāo)時(shí)，可以通過(guò) Format 屬性中的 HorizontalOrigin、HorizontalPosition、VerticalOrigin 和 VerticalPosition 來(lái)設(shè)置。同時(shí)，文本框內(nèi)部文字與邊框之間的間距（內(nèi)邊距）也可以通過(guò) InternalMargin 屬性進(jìn)行控制，這對(duì)于設(shè)計(jì)緊湊型排版尤為重要。

from spire.doc import *
from spire.doc.common import *

outputFile = "TextBoxFormat.docx"

# 創(chuàng)建文檔
doc = Document()
sec = doc.AddSection()

# 添加文本框并寫(xiě)入示例文字
tb = sec.AddParagraph().AppendTextBox(310, 90)
para = tb.Body.AddParagraph()
textRange = para.AppendText("通過(guò)編程方式設(shè)置文本框的位置和樣式，可以實(shí)現(xiàn)精確的文檔排版控制。")
textRange.CharacterFormat.FontName = "Cambria"
textRange.CharacterFormat.FontSize = 13

# 設(shè)置文本框的精確位置
tb.Format.HorizontalOrigin = HorizontalOrigin.Page
tb.Format.HorizontalPosition = 120
tb.Format.VerticalOrigin = VerticalOrigin.Page
tb.Format.VerticalPosition = 100

# 設(shè)置邊框樣式
tb.Format.LineStyle = TextBoxLineStyle.Double
tb.Format.LineColor = Color.get_CornflowerBlue()
tb.Format.LineDashing = LineDashing.Solid
tb.Format.LineWidth = 5

# 設(shè)置內(nèi)邊距
tb.Format.InternalMargin.Top = 15
tb.Format.InternalMargin.Bottom = 10
tb.Format.InternalMargin.Left = 12
tb.Format.InternalMargin.Right = 10

doc.SaveToFile(outputFile, FileFormat.Docx)
doc.Close()

HorizontalOrigin 和 VerticalOrigin 決定了位置坐標(biāo)的參照系，設(shè)置為 HorizontalOrigin.Page 表示以頁(yè)面為基準(zhǔn)，也可以選擇以段落或頁(yè)邊距為基準(zhǔn)。HorizontalPosition 和 VerticalPosition 則分別指定相對(duì)于參照系的水平和垂直偏移量（單位為磅）。InternalMargin 的 Top、Bottom、Left、Right 四個(gè)屬性控制文本框內(nèi)文字與四周邊框之間的留白距離，合理的內(nèi)邊距能讓文字在文本框中呼吸感更好，避免內(nèi)容緊貼邊框。LineWidth 屬性以磅為單位設(shè)置邊框粗細(xì)，配合 LineDashing 可以實(shí)現(xiàn)實(shí)線、點(diǎn)線、虛線等多種邊框效果。

刪除文本框

當(dāng)文檔中包含不再需要的文本框時(shí)，可以通過(guò) Document.TextBoxes 集合來(lái)訪問(wèn)和管理所有文本框。Spire.Doc 提供了 RemoveAt() 方法按索引刪除單個(gè)文本框，以及 Clear() 方法一次性清空所有文本框。刪除操作直接作用于文檔對(duì)象模型，保存后即生效。

from spire.doc import *
from spire.doc.common import *

inputFile = "./Data/TextBoxTemplate.docx"
outputFile = "RemoveTextBox.docx"

# 加載文檔
doc = Document()
doc.LoadFromFile(inputFile)

# 刪除第一個(gè)文本框
doc.TextBoxes.RemoveAt(0)

# 如需清空所有文本框，取消下面這行注釋
# doc.TextBoxes.Clear()

doc.SaveToFile(outputFile, FileFormat.Docx)
doc.Close()

TextBoxes 是文檔級(jí)別的集合，包含了當(dāng)前文檔中所有的文本框?qū)ο?，無(wú)論它們位于哪個(gè)節(jié)或段落中。RemoveAt(0) 刪除集合中索引為 0 的文本框，即文檔中第一個(gè)文本框。需要注意的是，每次刪除操作后集合的索引會(huì)自動(dòng)調(diào)整，因此在批量刪除時(shí)建議從后往前遍歷，或者直接使用 Clear() 方法。如果只需要?jiǎng)h除特定條件的文本框，可以先遍歷 TextBoxes 集合檢查其內(nèi)容或位置屬性，再調(diào)用 RemoveAt() 進(jìn)行精確刪除。

實(shí)用技巧

從文本框中提取文字

在某些場(chǎng)景下，我們需要將文本框中的文字內(nèi)容提取出來(lái)用于其他用途。Spire.Doc 允許遍歷文檔中的所有文本框，并訪問(wèn)其內(nèi)部的段落和表格內(nèi)容。通過(guò)判斷 ChildObjects 中各元素的 DocumentObjectType，可以區(qū)分段落和表格并分別提取文字。

document = Document()
document.LoadFromFile("./Data/ExtractTextFromTextBoxes.docx")

if document.TextBoxes.Count > 0:
    for i in range(document.TextBoxes.Count):
        textbox = document.TextBoxes.get_Item(i)
        for j in range(textbox.Body.Paragraphs.Count):
            para = textbox.Body.Paragraphs.get_Item(j)
            print(para.Text)

這段代碼遍歷文檔中所有文本框，依次輸出每個(gè)文本框內(nèi)的段落文字。如果文本框中包含表格，則需要進(jìn)一步遍歷表格的行和單元格來(lái)提取完整內(nèi)容。

批量添加格式統(tǒng)一的文本框

在制作模板類文檔時(shí)，往往需要添加多個(gè)格式完全一致的文本框?？梢詫⑽谋究虻母袷皆O(shè)置封裝為函數(shù)，在循環(huán)中調(diào)用，從而避免重復(fù)代碼并保證樣式統(tǒng)一。

總結(jié)

本文主要介紹了如何使用 Python 借助 Spire.Doc 在 Word 文檔中創(chuàng)建、設(shè)置和刪除文本框。通過(guò)文本框?qū)ο竽Ｐ?，可以靈活控制文本框的樣式、位置以及內(nèi)部?jī)?nèi)容，實(shí)現(xiàn)對(duì)文檔布局的自動(dòng)化管理。同時(shí)，本文還介紹了文本框的批量刪除和內(nèi)容讀取方法，幫助開(kāi)發(fā)者更高效地處理文檔中的特殊排版元素。掌握這些操作后，可以進(jìn)一步應(yīng)用于自動(dòng)化文檔生成、模板填充、格式調(diào)整以及文檔清理等場(chǎng)景。在實(shí)際開(kāi)發(fā)過(guò)程中，應(yīng)根據(jù)具體需求合理管理文本框?qū)ο?，并在?zhí)行批量刪除操作時(shí)注意集合索引變化帶來(lái)的影響。

到此這篇關(guān)于Python代碼實(shí)現(xiàn)在Word文檔中添加或刪除文本框的文章就介紹到這了,更多相關(guān)Python添加或刪除Word文本框內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論