註釋通常用於提及文檔中的錯誤或討論其內容。使用註釋，您可以避免在電子郵件線程中進行冗長且永無止境的討論。在本文中，您將學習如何以編程方式在 Java 中添加和刪除註釋以標記 Word 文檔。
以下是下面簡要討論的主題：
用於註釋和標記 Word 文件的 Java API
GroupDocs.Annotation 提供處理註解的Java API。 API 允許從 Word 文檔和許多其他文件格式中添加、刪除和提取註釋。 支持的文檔格式包括；電子表格、演示文稿、圖像、PDF 文件、網頁、電子郵件、Visio 繪圖。
下載或配置
從下載部分 下載 JAR 文件，或者只獲取基於 maven 的 Java 應用程序的 pom.xml 的最新存儲庫和依賴項配置。
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>21.7.2</version>
</dependency>
在 Java 中為 Word 添加批註
讓我們為Word 文檔添加不同類型的批註。註釋有很多種類型，所以我們在這裡只介紹其中的幾種。
在 Java 中為 Word 添加箭頭註釋
以下是在 Java 中為 Word 文檔添加箭頭註釋的步驟。
- 使用 Annotator 類加載文檔。
- 使用 ArrowAnnotation 類初始化箭頭註釋。
- 調整箭頭註釋的位置、大小、頁碼。
- 使用 add() 方法添加創建的箭頭註釋。
- 使用適當的 save() 方法將帶註釋的 Word 文檔保存到路徑。
以下 Java 代碼示例顯示瞭如何向 Word 文檔添加箭頭註釋。
// 在 Java 中為 Word 文檔添加箭頭註釋
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
在 Java 中向 Word 插入矩形或區域註釋
以下是通過一些自定義向 DOC/DOCX 文檔添加矩形或區域註釋的步驟。它類似於添加箭頭註釋，但它使用 AreaAnnotation。
- 使用 Annotator 類加載 Word DOC/DOCX 文檔。
- 使用 AreaAnnotation 類初始化矩形註釋。
- 調整矩形的位置、大小和顏色。
- 設置其他屬性，如頁碼、背景、不透明度、樣式、筆寬、消息和時間。
- 將創建的矩形註釋添加到註釋器中。
- 使用 save() 方法將帶註釋的 Word 文檔保存到路徑中。
以下 Java 代碼示例顯示瞭如何將矩形/區域註釋添加到 Word 文檔。
// 在 Java 中的 Word 文檔中添加區域或矩形註釋
final Annotator annotator = new Annotator("path/document.docx");
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
在 Java 中為 Word 添加 Oval 或 Ellipse 註解
以下是在 Java 中向文檔添加 oval/ellipse 註釋的步驟。
- 使用 Annotator 類加載 DOC/DOCX 文檔。
- 使用 EllipseAnnotation 類初始化橢圓註釋。
- 設置初始化橢圓標註的位置和大小。
- 將創建的橢圓註釋添加到註釋器中。
- 使用適當的 save() 方法保存帶註釋的 Word 文件。
以下 Java 代碼示例顯示瞭如何向任何 Word 文檔添加卵形/橢圓註釋。
// 在 Java 的 Word 文檔中添加 Oval 或 Ellipse Annotation
final Annotator annotator = new Annotator("path/document.docx");
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
在 Java 中為 Word 插入距離註釋
同樣，您可以使用距離註釋提及兩點之間的距離。以下是在 Java 中為文檔添加距離標註的步驟。
- 加載 Word 文檔後，使用 DistanceAnnotation 類初始化距離註釋。
- 設置註釋的外觀。
- 將距離註釋添加到 Annotator 對象。
- 將註釋文檔保存在給定位置或使用正確的 save() 方法，
以下 Java 代碼示例顯示瞭如何向 DOC/DOCX 文檔添加距離註釋。
// 在 Java 中為 Word 文檔添加距離註釋
final Annotator annotator = new Annotator("path/document.docx");
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
從 Java 中的 Word DOC/DOCX 文件中刪除註釋
有多種方法可以從 Word 文檔中刪除批註。您可以通過提供刪除特定註釋的索引來刪除特定註釋。此外，您可以一次刪除所有註釋。用於刪除註釋的詳細信息和 Java 源代碼將在另一篇文章中討論。
以下是從 Word 文件中刪除所有註釋的步驟。
以下代碼顯示瞭如何從 Java 中的 Word 文件中刪除註釋。
// Java去除Word文檔中的所有註釋
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
結論
總而言之，您已經了解瞭如何在 Java 應用程序中向 Word 文檔添加批註。具體來說，我們使用 GroupDocs.Annotation for Java 向 Word DOC/DOCX 文件添加了箭頭、橢圓、面積和距離註釋。此外，您還看到瞭如何從任何 Word 文件中刪除所有註釋。現在，您可以嘗試構建自己的文檔註釋器 Java 應用程序。
從 文檔 和 GitHub 存儲庫了解有關 API 的更多信息。如需進一步查詢，請聯繫 論壇 上的支持。