PDActionNamed

PDActionNamedは、Apache PDFBox PDModel APIのクラスで、PDF文書内の名前付きアクションを表します。名前付きアクションは、PDF仕様 ( 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 ) で定義された定義済み操作で、次のページまたは前のページへの移動、印刷ダイアログの表示、文書を閉じるなどの標準的な動作を文書がトリガーできるようにします。このクラスは、Java開発者がPDFファイル内のこれらの標準化されたインタラクティブ要素を作成、読み取り、変更するための高レベルインターフェースを提供します。

PDActionNamedは、Apache PDFBoxのorg.apache.pdfbox.pdmodel.interactive.actionパッケージ内の具象実装クラスで、 ( 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アクションタイプ(GoToアクションやURIアクションなど)とは異なります。PDF仕様では、NextPage、PrevPage、FirstPage、LastPage、Printなどを含む固定セットの名前付きアクションが定義されています。PDActionNamedは、これらのアクション定義を格納する辞書構造をカプセル化し、Java APIを通じてアクション名を取得および設定するメソッドを提供します。このクラスは、PDFBoxのすべてのPDFアクションの基底クラスであるPDActionを継承し、アクション辞書内の/S(サブタイプ)値が/Namedの場合を特に処理します。

PDF処理アプリケーションを構築する開発者にとって、PDActionNamedは標準的なナビゲーション機能とユーティリティ機能を備えたインタラクティブなPDF文書を作成するための不可欠な機能を提供します。フォームボタン、リンク、または一般的なPDFビューア操作をトリガーする必要があるページアクションを扱う際には、このクラスを理解することが重要です。名前付きアクションはカスタム実装ではなく標準化された動作を呼び出すため、異なるPDFビューア間で一貫性が保証されます。これは、 ( 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 ) などの標準を参照するアクセシビリティ準拠文書で特に重要です。予測可能なナビゲーションコントロールは、支援技術の使いやすさを向上させます。PDActionNamedを使用することで、開発者は複雑なカスタムアクションやJavaScriptを実装することなく、プログラムによって生成されたPDF文書にプロフェッショナルグレードのインタラクティビティを追加できます。

PDActionNamedは、名前付きアクション仕様を含むCOSDictionary(PDF辞書オブジェクトの低レベルPDFBox表現)をラップすることで機能します。名前付きアクションを作成する際、開発者はPDActionNamedをインスタンス化し、定義済みのアクション名文字列(「NextPage」や「Print」など)を指定してsetN()メソッドを呼び出します。その後、クラスは基礎となる辞書に必要な/S /Namedエントリと、指定されたアクション名を含む/Nエントリを設定します。既存のPDFを読み取る場合、PDFBoxは/Namedサブタイプを持つアクション辞書を自動的に認識し、PDActionNamedオブジェクトをインスタンス化します。これらのオブジェクトは、PDAnnotationLinkやPDFormFieldButtonなどのインタラクティブ要素からgetAction()メソッドを使用して取得できます。このクラスは、アクション名がPDF仕様の要件に準拠していることを検証し、標準PDFビューアとの互換性を保証します。開発者は、これらのアクションを注釈、フォームフィールド、またはページイベントに添付して、Adobe Acrobat、ブラウザのPDFビューア、その他の準拠レンダリングエンジン全体で一貫して機能するインタラクティブな動作を作成できます。

• PDAction – PDActionNamedが継承する、Apache PDFBoxのすべてのアクションタイプの抽象基底クラス
• PDAnnotationLink – 名前付きアクションを含む関連付けられたアクションを持つことができるリンク注釈を表すPDFBoxクラス
• PDFormFieldButton – 送信、リセット、または印刷操作に名前付きアクションを一般的に使用するボタンフォームフィールドを表すクラス
• COSDictionary – 名前付きアクションの基礎データを格納するPDF辞書オブジェクトを表す低レベルPDFBoxクラス
• PDPageAdditionalActions – ページが開かれたり閉じられたりしたときに名前付きアクションをトリガーできるページレベルのイベントを管理するクラス