PDActionGoTo

PDActionGoToは、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 ) で定義されており、開発者は同一PDF文書内の特定の移動先へユーザーを誘導するナビゲーション動作を作成または操作できます。リンクやボタンのクリックなどのユーザー操作によってトリガーされると、PDActionGoToアクションは指定されたページまたは位置にジャンプします。

PDActionGoToは、PDF標準で定義されている基本的なナビゲーション機構の一つである/GoToというPDFアクションタイプをカプセル化したJavaクラスです。外部ナビゲーションアクション（リモート移動先へのGoToRやWebリンクのURIなど）とは異なり、PDActionGoToは文書内部のナビゲーションを専門的に処理します。このクラスは、アクションが現在の文書内のどこに移動すべきかを指定する移動先プロパティを取得・設定するメソッドを提供します。この移動先は、特定のページ、名前付き移動先、または座標とズームレベルで定義された位置を参照できます。PDActionGoToは基底クラスであるPDActionを継承し、 ( 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文書を扱う開発者にとって、PDActionGoToはユーザーフレンドリーなナビゲーション機能を実装するために不可欠です。これにより、目次リンク、セクション間の相互参照、複数ページにわたるワークフローでユーザーを誘導するインタラクティブフォームの作成が可能になります。このクラスを理解することは、 ( 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を開発する際に特に重要です。適切なナビゲーション構造は、支援技術を使用するユーザーの体験を大幅に向上させるためです。移動アクションをプログラム的に作成および変更できる機能により、開発者は複雑なインタラクティブ文書の生成を自動化し、大規模な文書セット全体でナビゲーションの一貫性を確保し、壊れたナビゲーションリンクや欠落したナビゲーションリンクを含む既存のPDFを修復または拡張できます。

PDActionGoToは、ナビゲーションの移動先を定義するPDDestinationオブジェクトへの参照を保存することで機能します。開発者が新しいPDActionGoToインスタンスを作成する際、setDestination()メソッドを使用して移動先を設定できます。このメソッドは、PDPageDestination（明示的なページターゲット用）またはPDNamedDestination（文書内の他の場所で定義された名前付き位置用）のいずれかを受け入れます。アクションは通常、注釈（リンク注釈など）、ブックマークエントリ、またはフォームフィールドに関連付けられます。PDFビューアが文書を処理し、ユーザーが関連要素と対話すると、ビューアはアクションから移動先情報を読み取り、それに応じて移動します。PDFBoxライブラリは基盤となるPDF辞書構造を処理し、高レベルのJavaオブジェクトと ( 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構文との間で変換を行います。開発者は、getAction()などのメソッドを使用して注釈やアウトライン項目から既存のPDActionGoToインスタンスを取得し、そのプロパティを変更したり、新しいインスタンスを作成して以前は静的だった要素にナビゲーション機能を追加したりできます。

• PDAction – ナビゲーション、フォーム送信、JavaScriptアクションを含む、PDFBoxにおけるすべてのアクションタイプの基底クラス
• PDDestination – ナビゲーションアクションのターゲット位置を表し、特定のページとビューパラメータを定義します
• PDAnnotationLink – PDF文書内でクリック可能なリンクを作成するために通常PDActionGoToを使用する注釈タイプ
• PDOutlineItem – 文書ナビゲーション用のPDActionGoToアクションを含むことが多いブックマークエントリ
• PDPageDestination – ページ番号と表示座標を明示的に識別する特定のタイプの移動先