使用 Java 為 Word 文件添加文字浮水印圖片

介紹

如果您需要 添加文字浮水印圖片 到 Word 文件 — 用於品牌化、安全或版本控制 — 那麼您來對地方了。在本教學中，我們將逐步說明如何使用 GroupDocs.Watermark for Java，在 Word 檔案的特定區段內的每張圖片上嵌入文字浮水印。完成後，您將擁有一段可重複使用的程式碼片段，可直接放入任何 Java 專案中。

快速回答

• 此範例使用哪個函式庫？ GroupDocs.Watermark for Java
• 主要關鍵字是什麼？ add text watermark images
• 需要授權嗎？ 免費試用可用於開發；正式環境需購買授權
• 可以只針對單一區段嗎？ 可以 — API 允許您依區段選取圖片
• 支援哪個 Java 版本？ Java 8+，搭配 Maven 或 Gradle 建置

「add text watermark images」是什麼？

將文字浮水印加入圖片，即在圖片上覆蓋半透明文字，使浮水印隨圖片一起顯示或列印。於 Word 文件中，這可防止視覺內容被未授權使用。

為什麼使用 GroupDocs.Watermark for Java？

• 完整文件支援 — 支援 DOCX、DOC 以及其他 Office 格式。
• 細緻控制 — 您可以選取單一區段、段落或圖片。
• 效能優化 — 處理大型檔案時佔用記憶體極低。

前置條件

• GroupDocs.Watermark for Java（版本 24.11 或更新）。
• Maven（或其他建置工具）用於管理相依性。
• 基本的 Java 知識以及您想要保護的 Word 文件。

設定 GroupDocs.Watermark for Java

若要使用 GroupDocs.Watermark for Java，請依照以下方式將其整合至您的專案：

Maven 設定：
在您的 pom.xml 檔案中加入以下設定：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

直接下載：
或者，從 GroupDocs.Watermark for Java 版本發布 下載最新版本。

取得授權

若要完整使用 GroupDocs.Watermark，建議取得授權。您可以先使用免費試用，或申請臨時授權以無限制探索所有功能。欲了解購買方案，請前往 GroupDocs 購買頁面。

java add watermark picture – 步驟說明

以下為完整示範，說明 java add watermark picture 功能，同時聚焦於添加文字浮水印圖片。

步驟 1：載入 Word 文件

首先，開啟您想要修改的 Word 檔案：

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY", loadOptions);

步驟 2：建立並自訂文字浮水印

定義浮水印文字、字型、對齊方式、旋轉角度與大小：

TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
watermark.setHorizontalAlignment(HorizontalAlignment.Center); // Center horizontally
watermark.setVerticalAlignment(VerticalAlignment.Center);   // Center vertically
watermark.setRotateAngle(45);                          // Set rotation angle to 45 degrees
watermark.setSizingType(SizingType.ScaleToParentDimensions);// Scale size relative to parent dimensions
watermark.setScaleFactor(1);                           // Maintain original scale factor

步驟 3：存取特定區段中的圖片

僅針對第一個區段內的圖片（您可以更改索引以針對其他區段）：

WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);
var images = content.getSections().get_Item(0).findImages();

步驟 4：將浮水印套用至每張圖片

遍歷取得的圖片，並嵌入文字浮水印：

for (var image : images) {
    image.add(watermark); // Add watermark to the current image
}

步驟 5：儲存並關閉

將更新後的文件寫入磁碟並釋放資源：

watermarker.save("YOUR_OUTPUT_DIRECTORY");
watermarker.close();

常見問題與解決方案

• 浮水印未顯示： 請確認文字顏色與圖片背景有足夠對比。您也可以透過 watermark.setOpacity(0.5); 調整不透明度。
• 大型檔案效能下降： 先壓縮圖片，並以區段方式逐段處理文件，而非一次載入整個檔案。

實務應用

1. 品牌化： 在與合作夥伴分享簡報前，於所有圖片加入公司統一浮水印。
2. 機密性： 保護內部手冊中的專屬圖表。
3. 版本控制： 為草稿圖片標記「Confidential Draft」以避免意外外洩。

效能考量

• 記憶體管理： 必須呼叫 watermarker.close(); 以釋放原生資源。
• 批次處理： 處理大量文件時，分小批次執行以降低記憶體使用。
• 圖片最佳化： 在加浮水印前，使用適當壓縮的 JPEG 或 PNG。

結論

現在您已掌握完整、可投入生產環境的方式，使用 Java 為 Word 文件中的圖片 添加文字浮水印圖片。此技術提升文件安全性、加強品牌形象，且讓您能細緻控制哪些圖片需加浮水印。

下一步： 探索其他浮水印類型（基於圖片的浮水印），嘗試不同的旋轉角度，或將此程式碼整合至更大的文件處理流程中。

常見問答

Q: 我可以將 GroupDocs.Watermark 用於其他檔案格式嗎？
A: 可以，除了 Word 外，該函式庫亦支援 PDF、Excel、PowerPoint 與圖片檔案。

Q: 如何變更浮水印的不透明度？
A: 呼叫 watermark.setOpacity(double opacity)，其中 opacity 的範圍為 0.0（透明）至 1.0（不透明）。

Q: 若文件有多個區段且包含圖片該怎麼辦？
A: 迭代 content.getSections()，對每個需要的區段套用相同的邏輯。

Q: 是否支援自訂字型？
A: 當然支援。建立 Font 物件時，提供 .ttf 檔案的完整路徑即可。

Q: 我可以改用圖片浮水印而非文字嗎？
A: 可以 — 使用 ImageWatermark 取代 TextWatermark，並遵循相同的 add 程式碼模式。

最後更新： 2026-01-16
測試環境： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs

資源

• 文件說明
• API 參考文件
• 下載 GroupDocs.Watermark for Java