IronPDFを使用してPythonで簡単にPDFに注釈を入れる方法

前提条件

IronPDF を使用して PDF に注釈を付ける作業を始める前に、次の前提条件が満たされていることを確認してください。

1. Python:コンピュータに Python がインストールされていることを確認します。 最新バージョンをダウンロードするには、Python の公式 Web サイトにアクセスしてください。
2. IDEをインストールする： IronPDFでPDFの作業を始める前に、IDEをインストールする必要があります。Python用の人気の統合開発環境（IDE）として、 PyCharmがおすすめです。 あるいは、PyCharm を使用したくない場合は、任意の IDE を使用することもできます。

3. IronPDF ライブラリ:ターミナルで次のコマンドを使用して IronPDF ライブラリをインストールします。

   pip install IronPDF

   pip install IronPDF

   SHELL

   ! IronPDFを使ってPythonでPDFに簡単に注釈を付ける方法、図1: IronPDFパッケージのインストール IronPDFパッケージをインストールする

4. .NET 6.0 ランタイム: IronPDF for Python は、正常に動作するために .NET 6.0 テクノロジに依存しています。 つまり、IronPDF for Python を効果的に使用するには、コンピューターに.NET 6.0 ランタイムがインストールされている必要があります。 おそらく、プロジェクト実行時に IronPDF の依存関係とともに自動的にインストールされます。

注意: pip (Python パッケージ マネージャー) を使用して IronPDF をインストールする場合は、IronPDF インストール パスがシステムのPATH変数に含まれていることを確認することが重要です。 この手順は、インストールおよび使用中に pip が IronPDF パッケージとその関連コンポーネントを見つけられるようにするために重要です。

ステップ1: IronPDFライブラリのインポート

最初の行は、IronPDF ライブラリから必要なモジュールをインポートし、PDF の操作と注釈に必要なクラスと関数にアクセスできるようにします。

from ironpdf import PdfDocument, TextAnnotation

from ironpdf import PdfDocument, TextAnnotation

ステップ2: 既存のPDFドキュメントの読み込み

このステップでは、 PdfDocumentクラスを使用して、"existing.pdf"という名前の既存の PDF ファイルを読み込みます。 このドキュメントは注釈を追加するためのベースとして使用されます。 また、サポートされている注釈タイプが追加されるページ インデックスを設定します。

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

ステップ3: 注釈パラメータの設定

次のコード行は、PDF に追加されるテキスト注釈のさまざまなプロパティを定義します。 これらのプロパティは、注釈の外観と動作に関する情報を提供します。

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

各プロパティが表す内容は次のとおりです。

*アノテーション:*アノテーション変数を設定し、アノテーション タイプを宣言します。 タイトル: 新しい注釈の主なタイトル。 件名: 注釈のサブタイトルまたは追加情報。 内容**: 注釈の主な内容。"付箋"コメントに似ています。 *アイコン: 注釈に関連付けられた視覚的なアイコン (この場合はヘルプ アイコン)。

• XとY : ページ上の注釈の左上隅の座標。 *幅と高さ*: 注釈の境界ボックスの寸法。 不透明度: 注釈の不透明度レベル (0 ～ 1 の範囲)。 印刷可能: 注釈を印刷するかどうか。 非表示**: 注釈が最初は非表示になっているかどうか。
• OpenByDefault : 注釈をデフォルトで開くかどうか。
• ReadOnly : 注釈が読み取り専用かどうか。 *回転可能: 注釈を回転できるかどうか。

その他の注釈タイプとプロパティについては、このコード例のページをご覧ください。

ステップ4: PDFに注釈を追加する

次のコード行は、作成されたテキスト注釈を PDF ドキュメント内の特定のページに追加します。

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

ステップ5: 注釈付きPDFを保存する

最後に、注釈が追加された更新された PDF ドキュメントをSaveAsメソッドを使用して保存します。

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

ステップ6: スクリプトの実行

ここで、すべてのコードをまとめて、先ほど作成した PyCharm プロジェクトでスクリプトを実行してみましょう。

1. PyCharm 内でスクリプトを実行するには、スクリプト エディター内の任意の場所を右クリックし、 Run annotatePDFを選択します。
2. PyCharm はスクリプトを実行し、IDE の下部にある実行コンソールに出力と潜在的なエラーが表示されます。
3. スクリプトが完了すると、プロジェクトと同じディレクトリに注釈付きの PDF ("annotated.pdf") が見つかります。

Output:

! IronPDFを使ってPythonでPDFに簡単に注釈を付ける方法、図4: 出力PDFファイル 出力PDFファイル