
PDF 頁面內的內容很難編輯,但 PDF 規範定義了一整套對象,可以將其添加到 PDF 頁面中而不會改變頁面內容。這些物件稱為註釋,其用途包括從標記頁面內容到實現表單等互動功能。
大多數 PDF 檢視器允許建立和編輯各種註釋類型,例如文字突出顯示、註釋、線條或形狀,並且無論建立的註釋類型如何,符合 PDF 規範的 PDF 檢視器也應支援所有註釋類型的渲染。但是,在處理大量文件時,手動新增註解的過程會變得繁瑣,因此程式設計 API 是一個可行的解決方案。我們將進一步討論如何使用 Aspose.PDF Cloud SDK for Java 在 PDF 文件中新增註解。
SDK 的安裝
Aspose.PDF Cloud SDK for Java 是一個程式設計 API,使 Java 程式設計師能夠建立、操作以及將現有 PDF 文件轉換為其他 支援的文件格式。可以透過 Maven 和 GitHub 下載 Cloud SDK。現在在您的 pom.xml 檔案中添加以下詳細信息,以便在您的 Maven 建置專案中下載並使用 Aspose.Pdf.jar。
<repositories>
<repository>
<id>aspose-cloud</id>
<name>artifact.aspose-cloud-releases</name>
<url>https://artifact.aspose.cloud/repo</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-pdf-cloud</artifactId>
<version>21.1.0</version>
<scope>compile</scope>
</dependency>
</dependencies>
欲了解更多信息,請訪問如何安裝 Aspose.Cloud SDKs。
此外,請注意,為了確保使用者隱私和資料完整性,我們所有的 API 僅供授權人員存取。因此,您需要先造訪 Aspose.Cloud 儀表板,如果您有 GitHub 或 Google 帳戶,只需註冊即可。否則,請點擊建立新帳戶按鈕並提供所需資訊。現在使用憑證登入儀表板並從儀表板展開應用程式部分並向下捲動至用戶端憑證部分以查看用戶端 ID 和用戶端金鑰詳細資訊。
使用 Java 刪除文字
有時我們需要將文件中的某些內容標記為過時,但不會將其從文件中刪除。刪除線(又稱刪除線)用一條水平線穿過單字的中心來表示。這意味著文字是錯誤的或過時的,並且最近被刪除或標記為錯誤或過時。我們可以使用 strikethroughSettings 屬性來設定刪除線註釋的設定。 strikethroughSettings 屬性用於設定刪除線條註釋的顏色、不透明度、作者、主題、modifiedDate 和 isLocked 屬性。
新增高亮註釋
突出顯示 PDF 中的內容至關重要,因為它使我們能夠注意到文件中的重要資訊。突出顯示是有效的,因為它首先要求讀者挑出重要的部分,然後提供一種有效的方法來稍後複習這些資訊。我們的雲端 API 提供了突出顯示 PDF 文件內內容的功能。下面給出了在 PDF 文件中添加高亮註釋的步驟。
- 首先,建立 PdfApi 的實例,同時提供 ClientSecret 和 ClientId 詳細資料。
- 我們建立一個 File 實例來從本機系統載入 PDF 文件,然後呼叫 PdfApi 類別的 uploadFile(…) 方法將文件上傳到雲端儲存。
- 現在建立一個 Rectangle 類別的實例來指定可以新增註解的矩形區域。
- 然後建立一個 Point 類型的 ArrayList 來保存有關繪製 HighlightAnnotation 的點的資訊。
- 建立 HighlightAnnotation 類別的物件並設定名稱、矩形區域、主題、標題、四點、註解修改日期。
- 下一步是建立一個 HighlightAnnotation 類型的 List,並將上面建立的 HighlightAnnotation 物件新增至此清單。
- 最後,呼叫 PdfApi 類別的 postPageHighlightAnnotations(…) 方法並傳遞來源 PDF、頁碼和註解清單作為參數。

圖 1:- 反白 PDF 檔案中的註釋。
您可以從以下鏈接下載上述範例中使用的範例文件
如何添加線註釋
與新增刪除線和高亮註解類似,此 API 還允許您在 PDF 文件中新增行註解。我們有一個名為 LineAnnotation 的類別來實現這個要求。下面給出了有關如何滿足此要求的更多詳細資訊。
- 首先,建立 PdfApi 的實例,同時提供 ClientSecret 和 ClientId 詳細資料。
- 或者,我們建立一個 File 實例來從本機系統載入 PDF 文件,然後呼叫 PdfApi 類別的 uploadFile(…) 方法將文件上傳到雲端儲存。如果該檔案已經在雲端儲存中可用,我們就可以使用它。
- 其餘物件初始化屬性與上述的 HighlithAnnotation 相同,只是我們需要建立 LineAnnotation 類別的對象,並使用 setStarting(…) 和 setEnding(…) 方法設定線的起點和終點。
在 PDF 中加入圓圈註釋
圓形註釋在 PDF 文件中也很常用,並且 API 很好地支援這種註釋類型。為了新增圓形註釋,請嘗試使用 CircleAnnotation 類別。下面指定的程式碼可用於滿足此要求。

圖 2:PDF 文件中的圓圈註解。
輸入的 PDF 文件和結果 PDF(如上所示)可以從以下鏈接下載:
快速提示
使用我們的免費線上 PDF 註釋應用程式,一鍵刪除 PDF 中的所有註釋。
結論
在這篇部落格中,我們討論了 Aspose.PDF Cloud SDK for Java 目前支援的各種註解類型。除了註釋之外,該 API 還支援大量與 PDF 格式相關的其他令人興奮的功能。欲了解更多信息,我們建議您進一步探索開發者指南。
請注意,我們始終致力於以最好的方式為客戶服務,並接受他們的回饋和建議。因此,如果您在使用 API 時遇到任何問題或有任何相關疑問,請隨時透過我們的 免費支援論壇 與我們聯絡。
相關文章
我們強烈建議您訪問以下連結以了解更多資訊: