Java 在 Word 文檔中添加或刪除文本框 Detail - java Lu_Lu Blog

Stories

Detail

Return

Java 在 Word 文檔中添加或刪除文本框 - Stories Detail

12:30 AM · Nov 07 ,2025

在日常辦公和自動化處理中，Word文檔操作是常見需求。本文將深入探討如何利用Java編程，通過強大的Spire.Doc for Java庫，高效地在Word文檔中添加、編輯乃至刪除文本框，助你輕鬆實現文檔自動化。

1. 庫介紹與安裝：Spire.Doc for Java 實踐指南

Spire.Doc for Java是一個功能強大的Java類庫，專為Word文檔的創建、讀取、寫入、轉換和打印而設計。它支持多種Word文檔格式，包括DOC、DOCX、RTF等。該庫提供了豐富的API，使得開發者能夠輕鬆操作Word文檔中的各種元素，如文本、圖片、表格、段落、樣式以及本文將重點介紹的文本框。其主要優勢在於無需安裝Microsoft Word即可獨立運行，且API設計直觀，易於上手。

環境配置與依賴引入

要在你的Java項目中使用Spire.Doc for Java，最常見的方式是通過Maven或Gradle引入依賴。

Maven 配置:

在你的pom.xml文件中添加以下依賴項：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>13.10.6</version>
    </dependency>
</dependencies>

如果你選擇手動引入JAR包，可以從e-iceblue官網下載對應的JAR文件，並將其添加到你的項目構建路徑中。

2. Java 在 Word 文檔中添加文本框

使用Spire.Doc for Java創建文本框非常直觀。首先需要創建一個Document對象，然後通過Section和Paragraph對象來添加文本框。

以下代碼示例展示瞭如何在 Word 文檔中添加一個基本的文本框，並在文本框中添加文本和圖片：

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.TextBox;
import com.spire.doc.fields.TextRange;

import java.awt.*;

public class InsertTextBox {
    public static void main(String[] args) {
        
        //創建 Document 類的對象
        Document doc = new Document();

        //載入Word文檔
        doc.loadFromFile("C:/示例.docx");

        //創建文本框，並設置其文本環繞方式
        TextBox tb = doc.getSections().get(0).getParagraphs().get(0).appendTextBox(120f, 230f);
        tb.getFormat().setTextWrappingStyle(TextWrappingStyle.Square);

        //設置文本框的位置
        tb.getFormat().setHorizontalOrigin(HorizontalOrigin.Right_Margin_Area);
        tb.getFormat().setHorizontalPosition(-100f);
        tb.getFormat().setVerticalOrigin(VerticalOrigin.Page);
        tb.getFormat().setVerticalPosition(165f);

        //設置文本框的邊框顏色和填充顏色
        tb.getFormat().setLineColor(Color.BLUE);
        tb.getFormat().setFillColor(new Color(203,234,253) );

        //在文本框中插入圖片
        Paragraph para = tb.getBody().addParagraph();
        DocPicture picture = para.appendPicture("C:/圖片.jpg");

        //設置段落對齊方式
        para.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

        //設置圖片大小
        picture.setHeight(90f);
        picture.setWidth(90f);

        //在文本框中插入文字
        para = tb.getBody().addParagraph();
        TextRange textRange = para.appendText("考古學家忙於挖掘時，伊恩•霍德正構建“後過程”考古學的後現代方法。"
                +"過程考古學是20世紀60年代一場運動的名稱，由劉易斯•賓福特領導，旨在使考古學更加科學。");

        //設置段落對齊方式
        para.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

        //設置字體
        textRange.getCharacterFormat().setFontName("等線");
        textRange.getCharacterFormat().setFontSize(9f);
        textRange.getCharacterFormat().setItalic(true);

        //保存文檔
        doc.saveToFile("插入文本框.docx", FileFormat.Docx_2013);
    }
}

示例代碼與運行效果
上述代碼片段提供了完整的文本框添加過程，包括定義文本框屬性、添加內容以及保存。運行這些代碼將生成插入文本框.docx兩個Word文檔。文檔中的文本框將包含文本、圖片，同時以藍色為背景，展示了Spire.Doc for Java在文本框樣式控制上的強大能力。

3. Java 在 Word 文檔中刪除文本框

刪除文本框通常需要先定位到目標文本框。Spire.Doc for Java允許我們遍歷文檔中的所有形狀（Shape），因為文本框在內部也是作為一種特殊形狀存在的。我們可以通過檢查形狀的類型或其內部文本來識別並刪除特定的文本框。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class RemoveTextBox {
    public static void main(String[] args) {

        //創建 Document 類的對象
        Document doc = new Document();

        //載入Word文檔
        doc.loadFromFile("C:/示例.docx");

        //根據索引移除文本框
        doc.getTextBoxes().removeAt(0);

        //移除所有文本框
        //doc.getTextBoxes().clear();

        //保存文檔
        doc.saveToFile("移除文本框.docx", FileFormat.Docx);
    }
}

示例代碼與運行效果
上方代碼將根據索引刪除特定文本的文本框，同時如果想要移除全部的文本框，則調用doc.getTextBoxes().clear()方法。這些示例清晰地展示了Spire.Doc for Java在文本框刪除操作上的靈活性和精確性。

4. 常見問題與注意事項

編碼問題與解決方案

在使用Spire.Doc for Java處理中文文本時，偶爾可能會遇到亂碼問題。這通常是由於文件編碼或Java環境編碼設置不一致導致的。

文件編碼：確保你的源文件（.java）編碼為UTF-8。
JVM參數：在運行Java程序時，可以嘗試添加-Dfile.encoding=UTF-8參數來強制JVM使用UTF-8編碼。
文檔加載/保存： Spire.Doc for Java通常能很好地處理各種編碼，但如果遇到問題，請檢查文檔本身的編碼格式。

文本框定位與層級關係

座標系統： Spire.Doc for Java中的文本框位置通常使用“點”（Point）作為單位，1英寸等於72點。在設置Bounds時，需要注意這個單位，否則可能導致文本框顯示位置不符合預期。
層級衝突：在Word文檔中，文本框可能與其他元素（如圖片、文字）存在層級關係。當文本框被添加到文檔中時，其默認層級可能會遮擋或被其他文檔元素遮擋。Spire.Doc for Java提供了調整形狀層級的方法，例如ShapeObject.setZOrder()，可以根據需要調整文本框的顯示順序。
錨點： Word文檔中的形狀通常會有一個錨點，決定其相對位置（例如，相對於段落、頁面或表格）。Spire.Doc for Java允許設置文本框的HorizontalOrigin和VerticalOrigin屬性來精確控制其錨點。

性能優化建議

批量操作：對於需要處理大量文本框的場景，儘量將文本框的創建和修改操作集中處理，減少對文檔對象的頻繁讀寫。
內存管理：處理大型Word文檔時，可能會消耗較多內存。在完成文檔操作後，及時釋放Document對象，例如將其設置為null，並建議使用try-finally結構確保資源的關閉。
避免不必要的遍歷：如果你知道要操作的文本框的具體位置或ID，應儘量避免遍歷整個文檔，直接定位可以提高效率。