PDFファイルの注釈は、コンテンツを詳しく説明するために使用されます。注釈には、メモ、ポップアップ、または矢印や線などのグラフィックオブジェクトがあります。PDFファイルは編集できないため、注釈を使用すると追加情報を提供できます。この記事では、PDFファイルの注釈をプログラムで操作する方法を学習します。特に、Javaを使用してPDFファイルの注釈を追加または削除する方法を学習します。
PDF注釈を追加または削除するJavaAPI
PDFアノテーションを追加または削除するには、Aspose.PDF for Javaを使用します。これは、Javaを使用してPDFファイルを生成、編集、および変換できる機能豊富なAPIです。さらに、APIを使用すると、さまざまなPDF注釈をシームレスに操作できます。 APIをダウンロードするか、次のMaven構成を使用してインストールできます。
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-pdf</artifactId>
<version>21.3</version>
</dependency>
Javaを使用してPDFに注釈を追加する
Aspose.PDF for Javaは、テキスト、線、円、正方形、ハイライトなどを含むがこれらに限定されない多くの注釈をサポートします。各注釈タイプを追加するために、Aspose.PDFforJavaは個別のクラスを提供します。たとえば、LineAnnotationクラスは行を追加するために使用され、HighlightAnnotationクラスはハイライト注釈を追加するために使用されます。
Javaを使用してPDFに注釈を追加する手順
デモンストレーションのために、PDFファイルにテキスト注釈を追加しましょう。以下は、Javaを使用してPDFにテキスト注釈を追加するためのAPIリファレンスとともに手順です。
- まず、Documentクラスを使用してPDFドキュメントをロードします。
- TextAnnotationクラスのオブジェクトを作成して、テキスト注釈を追加します。
- タイトル、件名などの注釈のプロパティを設定します。
- Borderクラスを使用して注釈の境界線を設定します。
- Document.getPages().get_Item(int).getAnnotations().add(Annotation)メソッドを使用して、ドキュメントに注釈を追加します。
- 最後に、Document.save(string)メソッドを使用して更新されたPDFを保存します。
次のコードサンプルは、Javaを使用してPDFにテキスト注釈を追加する方法を示しています。
// ソースPDFドキュメントを開く
Document pdfDocument = new Document("input.pdf");
// 注釈を作成する
TextAnnotation textAnnotation = new TextAnnotation(pdfDocument.getPages().get_Item(1), new com.aspose.pdf.Rectangle(200, 400, 400, 600));
// 注釈タイトルを設定する
textAnnotation.setTitle("Sample Annotation Title");
// 注釈の件名を設定する
textAnnotation.setSubject("Sample Subject");
textAnnotation.setState(AnnotationState.Accepted);
// 注釈の内容を指定する
textAnnotation.setContents("Sample contents for the annotation");
textAnnotation.setOpen(true);
textAnnotation.setIcon(TextIcon.Key);
Border border = new Border(textAnnotation);
border.setWidth(5);
border.setDash(new Dash(1, 1));
textAnnotation.setBorder(border);
textAnnotation.setRect(new com.aspose.pdf.Rectangle(200, 400, 400, 600));
// ページの注釈コレクションに注釈を追加します
pdfDocument.getPages().get_Item(1).getAnnotations().add(textAnnotation);
// 出力ファイルを保存します
pdfDocument.save("output.pdf");
Javaを使用してPDFから注釈を削除する
PDFのページから注釈を削除するために、Aspose.PDFforJavaには次のオプションがあります。
- ページ上の特定の注釈を削除します
- ページ上のすべての注釈を削除します
特定のPDF注釈を削除する
以下は、Javaを使用してPDFファイルから注釈を削除する手順です。
- まず、Documentクラスを使用してPDFドキュメントをロードします。
- Document.getPages().get_Item(int).getAnnotations().delete(int)メソッドを使用して、インデックスによって目的の注釈を削除します。
- 最後に、Document.save(string)メソッドを使用して更新されたPDFを保存します。
次のコードサンプルは、Javaを使用してPDFのページから特定の注釈を削除する方法を示しています。
// ソースPDFドキュメントを開く
Document pdfDocument = new Document("input.pdf");
// 特定の注釈を削除する
pdfDocument.getPages().get_Item(1).getAnnotations().delete(1);
// 更新ドキュメントを保存します
pdfDocument.save("output.pdf");
すべてのPDF注釈を削除する
以下は、Javaを使用してPDFのページ上のすべての注釈を削除する手順です。
- まず、Documentクラスを使用してPDFドキュメントをロードします。
- Document.getPages().get_Item(int).getAnnotations().delete()メソッドを使用してすべての注釈を削除します。
- 最後に、Document.save(string)メソッドを使用して更新されたPDFを保存します。
次のコードサンプルは、Javaを使用してPDFのページ上のすべての注釈を削除する方法を示しています。
// オープンソースのPDFドキュメント
Document pdfDocument = new Document("input.pdf");
// すべての注釈を削除する
pdfDocument.getPages().get_Item(1).getAnnotations().delete();
// 更新ドキュメントを保存します
pdfDocument.save("output.pdf");
無料のAPIライセンスを取得する
一時ライセンスを使用すると、評価の制限なしにAspose.PDFforJavaを無料で試すことができます。
結論
この記事では、PDFファイルの注釈を操作する方法を学びました。特に、Javaを使用してPDFファイルの注釈を追加または削除する方法を見てきました。 ドキュメントを使用して、Aspose.PDFforJavaの詳細を調べることができます。ご不明な点やご質問がございましたら、フォーラムからお知らせください。