PDNamedDestination

PDNamedDestinationは、Apache PDFBox PDModel APIのクラスで、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作成者が特定のページやビューなど、ドキュメント内の特定の場所への再利用可能な参照を作成できるようにします。このクラスは、JavaアプリケーションでPDFファイルを扱う際に、名前付き宛先をプログラムで読み取り、作成、変更するためのメソッドを開発者に提供します。

PDNamedDestinationは、Apache PDFBoxのPDModel API内の高レベルJavaクラスで、PDFの名前付き宛先を操作するための機能をカプセル化しています。ページとビューパラメータをインラインで指定する直接宛先とは異なり、名前付き宛先は間接参照メカニズムを提供し、文字列名がドキュメントの名前辞書に格納された宛先オブジェクトにマッピングされます。PDNamedDestinationクラスは、 ( 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構文を抽象化し、これらの名前付き参照を管理するための開発者にとって使いやすいインターフェースを提供します。これは、実際の宛先ターゲット（ページとビュー）を表すPDPageDestinationなどのクラスとは異なり、PDNamedDestinationはそれらのターゲットを参照する命名と検索のメカニズムを処理します。

名前付き宛先は、PDFドキュメント内および複数のドキュメント間で安定した保守可能なリンクを作成するために不可欠です。PDF生成、操作、またはアクセシビリティツールを構築する開発者にとって、PDNamedDestinationは、ページ番号が変更されても有効なままのブックマーク、ハイパーリンク、ドキュメントの相互参照を作成するための重要な機能を提供します。これは ( 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にとって特に重要で、名前付き宛先により支援技術がドキュメントを予測可能な方法でナビゲートできるようになります。PDNamedDestinationクラスを通じて名前付き宛先を使用することで、外部ドキュメントが脆弱なページインデックスではなく人間が読める名前を使用して特定の場所に確実にリンクできるため、相互運用性も向上します。

PDNamedDestinationクラスは、PDFドキュメントのNames辞書、特に宛先マッピングを格納する「Dests」名前ツリーと対話するメソッドを提供することで機能します。名前付き宛先を作成する際、開発者はPDNamedDestinationを使用して、文字列識別子をターゲットページとビューパラメータ（フィットタイプ、ズームレベル、特定の座標など）を指定するPDPageDestinationオブジェクトに関連付けます。このクラスは、 ( 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構造へのこれらのマッピングのシリアル化を処理します。名前付き宛先を取得するために、クラスはドキュメントの名前ツリーを照会し、対応する宛先オブジェクトを返します。これを使用してその場所にナビゲートできます。PDFBoxの実装は、基礎となる名前ツリーデータ構造の複雑さを管理し、開発者がPDF仕様への準拠を保証しながら、シンプルなキー・バリューのセマンティクスで作業できるようにします。

• PDPageDestination – ページ参照とビューパラメータを含む、PDF内の実際のターゲット場所を表します
• PDDocumentNameDictionary – 名前付き宛先を含む、PDFドキュメント内のさまざまな名前付きリソースを管理するコンテナクラス
• PDOutlineItem – ナビゲーションのために名前付き宛先を参照できるブックマークエントリ
• PDAnnotationLink – ハイパーリンクのターゲットとして名前付き宛先を使用できるリンク注釈
• PDActionGoTo – 直接宛先または名前付き宛先のいずれかである宛先にナビゲートするアクション