在日常的 Java 應(yīng)用開(kāi)發(fā)中，我們經(jīng)常需要與各種文檔格式打交道，其中 Word 文檔以其廣泛的應(yīng)用性占據(jù)重要地位。對(duì) Word 文檔進(jìn)行自動(dòng)化處理，例如動(dòng)態(tài)生成報(bào)告、填充模板或?qū)?nèi)容進(jìn)行格式化，是許多業(yè)務(wù)場(chǎng)景的剛性需求。本文將聚焦于一個(gè)常見(jiàn)的格式化需求：如何使用 Java 為 Word 文檔中的指定文本或段落添加邊框。我們將借助強(qiáng)大的第三方庫(kù) Spire.Doc for Java，詳細(xì)講解其實(shí)現(xiàn)原理與具體步驟，幫助開(kāi)發(fā)者高效解決這一問(wèn)題。

Spire.Doc for Java 庫(kù)簡(jiǎn)介與環(huán)境配置

Spire.Doc for Java 是一個(gè)專(zhuān)業(yè)的 Word 文檔處理組件，專(zhuān)為 Java 應(yīng)用程序設(shè)計(jì)。它允許開(kāi)發(fā)者在不依賴 Microsoft Word 應(yīng)用程序的情況下，創(chuàng)建、讀取、寫(xiě)入、修改和轉(zhuǎn)換 Word 文檔。其功能涵蓋了從文本、段落、表格、圖片到頁(yè)眉頁(yè)腳、批注、書(shū)簽、表單域等 Word 文檔的幾乎所有元素。Spire.Doc 的優(yōu)勢(shì)在于其豐富的 API、高性能以及對(duì) Word 格式的良好兼容性。

環(huán)境配置：

要使用 Spire.Doc for Java，您需要將其作為依賴項(xiàng)添加到您的 Java 項(xiàng)目中。以下是 Maven 的配置示例：

Maven 依賴配置：

<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.9.19</version>
    </dependency>
</dependencies>

Java 實(shí)現(xiàn) Word 文檔文本邊框的添加

為 Word 文檔中的指定文本添加邊框，通常意味著對(duì)文本的 TextRange 對(duì)象進(jìn)行格式化。Spire.Doc 提供了直觀的 API 來(lái)實(shí)現(xiàn)這一功能。

操作步驟：

• 加載 Word 文檔： 使用 Document 類(lèi)加載現(xiàn)有的 Word 文檔。
• 查找目標(biāo)文本： 遍歷文檔的段落和文本范圍，找到需要添加邊框的特定文本。
• 獲取文本的 TextRange 對(duì)象： 找到目標(biāo)文本后，獲取其對(duì)應(yīng)的 TextRange 對(duì)象。
• 設(shè)置 TextRange 對(duì)象的邊框?qū)傩裕?通過(guò) TextRange 的 CharacterFormat 訪問(wèn)其邊框設(shè)置，包括邊框類(lèi)型、顏色、寬度等。
• 保存文檔： 將修改后的文檔保存到指定路徑。

代碼示例：

下面這個(gè)代碼展示了怎樣在 Word 文檔中給 “AI繪畫(huà)” 這個(gè)文本添加邊框：

import com.spire.doc.*;
import com.spire.doc.documents.BorderStyle;
import com.spire.doc.documents.TextSelection;
 
import java.awt.*;
 
public class AddBorderToText {
   public static void main(String[] args) {
       // 加載Word文檔
       Document doc = new Document();
       doc.loadFromFile("/AI繪畫(huà)的利與弊.docx");
 
       // 查找文本
       TextSelection[] textSelections1 = document.findAllString("AI繪畫(huà)", false, false);
 
       // 給文本字符串添加邊框并設(shè)置邊框的樣式
       for (TextSelection selection : textSelections1)
       {
           selection.getAsOneRange().getCharacterFormat().getBorder().setBorderType(BorderStyle.Single);
           selection.getAsOneRange().getCharacterFormat().getBorder().setColor(Color.green);
           selection.getAsOneRange().getCharacterFormat().getBorder().setLineWidth(2);
       }
 
 
       // 保存結(jié)果文檔
       document.saveToFile("/給文本添加邊框.docx", FileFormat.Docx_2013);
   }
}

代碼解釋?zhuān)?/p>

• doc.loadFromFile("/AI繪畫(huà)的利與弊.docx");: 加載 Word 文檔。
• TextSelection[] textSelections1 = document.findAllString("AI繪畫(huà)", false, false);: 查找目標(biāo)文本。
• selection.getAsOneRange().getCharacterFormat().getBorder().setBorderType(BorderStyle.Single);: 設(shè)置邊框的樣式為單線。BorderStyle 枚舉提供了多種邊框樣式，如 Dot, DashDot, Double 等。
• selection.getAsOneRange().getCharacterFormat().getBorder().setColor(Color.green);: 設(shè)置上邊框的顏色為綠色。
• selection.getAsOneRange().getCharacterFormat().getBorder().setLineWidth(2);: 設(shè)置上邊框的線寬，單位是磅 (points)。

Java 實(shí)現(xiàn) Word 文檔段落邊框的添加

為 Word 文檔中的指定段落添加邊框，意味著對(duì)整個(gè) Paragraph 對(duì)象進(jìn)行格式化。段落邊框與文本邊框的主要區(qū)別在于，段落邊框是圍繞整個(gè)段落（包括其內(nèi)容和可能的縮進(jìn)、行距等）的。

操作步驟：

• 加載 Word 文檔。
• 獲取段落的 Paragraph 對(duì)象。
• 設(shè)置 Paragraph 對(duì)象的邊框?qū)傩裕?通過(guò) Paragraph 的 Format 訪問(wèn)其邊框設(shè)置，包括邊框類(lèi)型、顏色、寬度、邊距等。
• 保存文檔。

代碼示例：

假設(shè)我們想給文檔中的第二個(gè)段落添加邊框。

import com.spire.doc.*;
import com.spire.doc.documents.BorderStyle;
import com.spire.doc.documents.Paragraph;
 
import java.awt.*;
 
public class AddBordertoPara {
   public static void main(String[] args) {
       // 加載文檔
       Document doc = new Document();
       doc.loadFromFile("/AI繪畫(huà)的利與弊.docx");
 
       // 獲取第二個(gè)段落
       Paragraph para = doc.getSections().get(0).getParagraphs().get(1);
 
       // 設(shè)置段落邊框類(lèi)型，邊框顏色、線條寬度
       para.getFormat().getBorders().setBorderType(BorderStyle.Dot);
       para.getFormat().getBorders().setColor(new Color(18,100,223));
       para.getFormat().getBorders().setLineWidth(2);
 
       // 保存文檔
       doc.saveToFile("/給段落添加邊框.docx",FileFormat.Docx_2013);
       doc.dispose();
   }
}

代碼解釋?zhuān)?/strong>