在日常的自動化文檔處理中，我們經常會遇到需要對 Word 文檔內容進行編程修改的需求，其中一項常見且重要的操作就是更改文本的顏色。無論是為了突出重點、統一品牌風格，還是實現動態內容展示，精準地修改文本顏色都是一個核心痛點。本文將深入探討如何使用強大的 Java 庫 Spire.Doc for Java 來高效、靈活地實現 Word 文檔中文本顏色的更改，為廣大 Java 開發者提供一個清晰、實用的解決方案。

Spire.Doc for Java 庫簡介與安裝

Spire.Doc for Java 是一個專業的 Word 文檔處理組件，它允許開發者在 Java 應用程序中創建、讀取、寫入、轉換和打印 Word 文檔。該庫提供了豐富的 API，能夠處理 Word 文檔的各種元素，包括文本、段落、表格、圖片、超鏈接等，極大地簡化了復雜的文檔操作。

Maven 依賴配置

要在您的項目中集成 Spire.Doc for Java，最便捷的方式是通過 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.8.7</version></dependency>
</dependencies>

Java 更改指定段落的文本顏色

修改 Word 文檔中某個特定段落的文本顏色是一個常見的需求。Spire.Doc 允許我們通過段落索引來定位，然后遍歷其內部的文本范圍并設置顏色。

以下代碼示例演示了如何加載一個 Word 文檔，并將第一個段落的所有文本顏色更改為藍色：

import?com.spire.doc.Document;
import?com.spire.doc.FileFormat;
import?com.spire.doc.Section;
import?com.spire.doc.documents.Paragraph;
import?com.spire.doc.documents.ParagraphStyle;import?java.awt.*;public?class?ChangeFontColorForParagraph?{public?static?void?main(String?[]args){//創建一個Document實例Document?document?=?new?Document();//加載Word文檔document.loadFromFile("C:\\Users\\Administrator\\Desktop\\Sample.docx");//獲取第一節Section?section?=?document.getSections().get(0);//更改第一個段落的文本顏色Paragraph?p1?=?section.getParagraphs().get(0);ParagraphStyle?s1?=?new?ParagraphStyle(document);s1.setName("Color1");s1.getCharacterFormat().setTextColor(new?Color(188,?143,?143));document.getStyles().add(s1);p1.applyStyle(s1.getName());//更改第二段的文本顏色Paragraph?p2?=?section.getParagraphs().get(1);ParagraphStyle?s2?=?new?ParagraphStyle(document);s2.setName("Color2");s2.getCharacterFormat().setTextColor(new?Color(0,?0,?139));;document.getStyles().add(s2);p2.applyStyle(s2.getName());//保存結果文檔document.saveToFile("ChangeParagraphTextColor.docx",?FileFormat.Docx);}
}

代碼解釋：

• document.loadFromFile("input.docx")：加載名為 input.docx 的 Word 文檔。
• document.getSections().get(0)：獲取文檔的第一個節。
• section.getParagraphs().get(0)：獲取第一個節中的第一個段落。
• s1.getCharacterFormat().setTextColor(new Color(188, 143, 143))：給獲取到段落中的文本設置新的顏色，該顏色通過 RGB 值指定。
• document.saveToFile()：保存修改后的文檔。

Java 更改指定文本的顏色

有時候，我們可能需要更精細地控制，只修改文檔中特定文本內容的顏色，而不是整個段落。Spire.Doc 提供了查找功能，可以幫助我們定位到這些特定的文本。

以下代碼示例演示了如何在文檔中查找所有匹配“Spire.Doc for .NET”的文本，并將其顏色更改為紅色：

import?com.spire.doc.Document;
import?com.spire.doc.FileFormat;
import?com.spire.doc.documents.TextSelection;import?java.awt.*;public?class?ChangeFontColorForText?{public?static?void?main(String?[]args){//創建一個Document實例Document?document?=?new?Document();//加載Word文檔document.loadFromFile("C:\\Users\\Administrator\\Desktop\\Sample.docx");//找到要更改字體顏色的文本TextSelection[]?text?=?document.findAllString("Spire.Doc?for?.NET",?false,?true);//更改搜索文本的字體顏色for?(TextSelection?seletion?:?text){seletion.getAsOneRange().getCharacterFormat().setTextColor(Color.red);}//保存結果文檔document.saveToFile("ChangeCertainTextColor.docx",?FileFormat.Docx);}
}

代碼解釋：

• document.findAllString()：在整個文檔中查找所有匹配字符串的文本。false 表示不區分大小寫，true 表示匹配整個單詞。
• selection.getAsOneRange()：將找到的文本選擇轉換為一個 TextRange 對象，方便進行格式修改。
• TextRange.getCharacterFormat().setTextColor()：設置查找到的特定文本的顏色。

總結

Spire.Doc for Java 提供了一套強大而靈活的 API，使得在 Java 應用程序中更改 Word 文檔中文本顏色變得簡單高效。通過上述示例，我們不僅學會了如何修改整個段落的文本顏色，還掌握了如何精準定位并修改文檔中特定文本的顏色。無論是進行自動化報告生成、文檔內容審查，還是實現個性化文檔定制，Spire.Doc for Java 都在自動化文檔處理中展現出其卓越的價值。鼓勵開發者們進一步探索 Spire.Doc for Java 的更多功能，以應對更復雜的文檔處理需求。