PDDocumentNameDestinationDictionary

PDDocumentNameDestinationDictionaryは、Apache PDFBoxライブラリのJavaクラスで、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ドキュメント内の特定の場所を参照する方法を提供します。この高レベルなPDModel APIクラスにより、開発者はPDFドキュメントを扱う際に、これらの名前付き位置参照にプログラム的にアクセスし、操作することができます。

PDDocumentNameDestinationDictionaryは、Apache PDFBoxのPDModelパッケージ内の専門クラスで、PDFファイル内の名前付き宛先辞書を扱うための機能をカプセル化します。名前付き宛先辞書は、文字列名を宛先オブジェクトにマッピングし、宛先オブジェクトは特定のページビュー、ズームレベル、スクロール位置などのドキュメント内の場所を指定します。ページインデックスや座標を使用する直接的な宛先オブジェクトとは異なり、名前付き宛先は、ページ番号が変更されたり、ドキュメントが再編成されたりしても有効な抽象化レイヤーを提供します。このクラスは、宛先名の読み取り、関連する宛先オブジェクトの取得、これらのマッピングのプログラム的な変更を行うメソッドを提供します。これは、PDFのドキュメントカタログ内で名前付き宛先を整理する辞書構造を特に扱うという点で、PDFBox内の他の宛先関連クラスとは異なります。

インタラクティブなPDFドキュメントを扱う開発者にとって、名前付き宛先は、ドキュメント構造が変更されても壊れない安定した内部リンクおよび外部リンクを作成するために不可欠です。このクラスにより、開発者は目次の生成、クロスドキュメントリンク、ブックマーク管理などの機能を堅牢な方法で実装できます。名前付き宛先は、PDF/UA ( 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にとって特に重要です。一貫したナビゲーション構造により、支援技術がユーザーをドキュメントコンテンツ全体に案内するのに役立ちます。PDDocumentNameDestinationDictionaryを使用することで、開発者はPDFドキュメント内の既存の名前付き宛先をプログラム的に検査したり、ナビゲーション目的で新しい宛先を作成したり、ドキュメントの再構築時に更新したりして、ドキュメントの改訂を通じてリンクが機能的でアクセシブルであることを保証できます。

PDDocumentNameDestinationDictionaryクラスは、 ( 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ドキュメントの名前ツリー内のDestsエントリを表す基礎となるCOS（Carousel Object Structure）辞書をラップすることで動作します。開発者がPDFBoxを通じてこのクラスにアクセスすると、PDFに格納された名前から宛先へのマッピングと対話するための高レベルメソッドが提供されます。このクラスは通常、ドキュメント内のすべての名前付き宛先の列挙、名前による特定の宛先の取得、辞書構造の変更を可能にします。内部的には、PDFBoxのオブジェクト指向Javaの表現とPDFファイル形式の低レベル辞書構造の間で変換を行います。読み取り時には、名前ツリー構造を解析して、値が宛先配列または宛先辞書である名前と値のペアを抽出します。書き込み時には、変更がCOSレイヤーに適切にシリアル化され、PDF仕様への準拠が維持されるようにします。開発者は通常、ドキュメントの論理構造のルートとして機能するPDDocumentCatalogオブジェクトを通じてこのクラスにアクセスします。

• PDDestination – リンクや名前付き宛先から参照できる、PDFドキュメント内の特定の場所またはビューを表します
• PDDocumentCatalog – 名前付き宛先やその他のドキュメントレベルの構造への参照を含む、PDFドキュメントのオブジェクト階層のルートオブジェクトです
• PDPageDestination – ズームレベルや位置などのオプションのビューパラメータを持つ特定のページを参照する宛先の特定のタイプです
• PDOutlineItem – PDF内のブックマークエントリで、多くの場合、名前付き宛先を使用してドキュメントの場所にリンクします
• Name Tree – PDF仕様で定義されているように、宛先を含む名前付きリソースに対して効率的なキーと値のストレージを提供するPDFデータ構造です