PDAdditionalActions

PDAdditionalActionsは、Apache PDFBoxのPDModel APIに含まれるクラスで、PDFオブジェクトに関連付けられた追加アクション（Additional Actions）へのプログラマティックなアクセスを提供します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されている追加アクションは、文書を開く・閉じる、ページに入る・出る、フォームフィールドや注釈と対話するなどのイベントに応答して、PDF文書が特定の動作をトリガーできるようにします。このクラスを使用することで、開発者はPDF文書内でこれらのイベント駆動型の動作を読み取り、変更、または作成できます。

PDAdditionalActionsは、Apache PDFBoxライブラリ内の高レベルなJavaクラスで、文書カタログ、ページ、注釈、フォームフィールドなど、さまざまなPDFオブジェクトに関連付けることができるオプションの追加アクション辞書（AAエントリ）を表します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) によれば、追加アクションは、ユーザーのクリックだけでなく、特定のイベントによって複数のアクションをトリガーできるようにすることで、基本的なアクション機構を拡張します。ユーザーの操作時に即座に実行される単一のアクションとは異なり、追加アクションは「WillClose」（文書を閉じる前）、「DidPrint」（印刷後）、「PageOpen」（ページが表示される時）などの異なるトリガーイベントに異なるアクションを関連付ける構造化された方法を提供します。PDAdditionalActionsクラスは、基盤となる辞書構造を抽象化し、開発者が低レベルのPDF構文を直接操作することなく、型安全なgetterおよびsetterメソッドを使用してこれらのイベント・アクションの関連付けを扱えるようにします。

インタラクティブなPDF文書を扱う開発者にとって、PDAdditionalActionsは、ユーザー体験と文書機能を向上させる高度な文書動作を実装するために不可欠です。このクラスにより、フォームフィールドが変更された際の計算実行、検証スクリプトのトリガー、フィールド値の動的更新、文書使用イベントのログ記録などのタスクの自動化が可能になります。 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) で指摘されているように、追加アクションの理解と適切な実装は、アクセシブルなPDF開発において特に重要です。予測可能な文書動作と適切なイベント処理は、支援技術のサポート向上に貢献します。PDAdditionalActionsがなければ、開発者は複雑な辞書構造を手動で構築および解析する必要があり、エラーのリスクが高まり、PDFの操作が著しく困難でエラーが発生しやすくなります。

PDAdditionalActionsは、COSDictionary（低レベル表現）をラップし、PDF仕様で定義された特定のアクションタイプにアクセスするための便利なメソッドを提供することで機能します。このクラスは通常、閉じるアクション用のgetC()、開くアクション用のgetO()、その他のイベントタイプ用の同様のメソッドを提供し、実行される特定のアクションを表すPDActionオブジェクトを返します。PDFを読み取る際、開発者はPDFオブジェクト（PDPageやPDAnnotationなど）から取得した既存の辞書からPDAdditionalActionsをインスタンス化し、適切なgetterメソッドを呼び出して、どのアクションが設定されているかを検査します。追加アクションを作成または変更する際、開発者はアクションオブジェクト（JavaScriptアクション用のPDActionJavaScriptなど）をインスタンス化し、setterメソッドを使用して特定のイベントに関連付けます。基盤となる辞書構造は、 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 仕様に準拠するように自動的に更新されます。このクラスは、ユーザーフレンドリーなメソッド名とPDFファイル形式で使用される省略キー（WillCloseの「WC」、DidCloseの「DC」など）の間のマッピングを処理し、これらの実装詳細を開発者から抽象化します。

• PDAction – PDF文書内で実行できるアクションを表す基底クラス
• PDActionJavaScript – PDFビューア内でJavaScriptコードを実行するための特定のアクションタイプ
• PDPage – PDF文書内の単一ページを表し、追加アクションを関連付けることができる
• PDAnnotation – PDF注釈を表し、対話時に追加アクションをトリガーできる
• PDDocumentCatalog – PDF文書のルートオブジェクトで、文書レベルの追加アクションを含むことができる