PDDestination

PDDestinationは、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ビューアが特定の文書位置にナビゲートし表示する方法を制御するデスティネーションオブジェクトを、プログラムで読み取り、作成、変更できます。

PDDestinationは、Apache PDFBoxにおける抽象基底クラスで、文書ページの特定のビューを定義する構造である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 ) では、デスティネーションはページ参照と、ページをどのように表示するかを決定するフィットタイプ（ウィンドウ幅に合わせる、特定のズームレベルで表示する、特定の座標に配置するなど）を組み合わせたものです。

PDDestinationは、単純なページ参照とは異なり、完全な表示コンテキストを提供します。つまり、どのページを表示するかだけでなく、正確にどのように表示するかも指定します。このクラス階層には、PDPageDestination（明示的なページデスティネーション用）やPDNamedDestination（文書の名前辞書内で名前により参照されるデスティネーション用）などの具象実装が含まれます。さまざまな動作をトリガーできるナビゲーションアクションとは異なり、デスティネーションは静的な表示状態を具体的に定義します。

このクラスは、ページ参照とフィットタイプを取得するメソッドを提供しますが、具体的なズーム係数や位置座標は具象サブクラスの実装を通じてアクセスします。PDDestinationオブジェクトは、ブックマーク（アウトライン項目）、リンク注釈、および正確なナビゲーション制御を必要とする他のインタラクティブなPDF要素で一般的に使用されます。

インタラクティブなPDF文書を扱う開発者にとって、PDDestinationはナビゲーション機能を実装するための重要な機能を提供します。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 ) 。スクリーンリーダーやその他のアクセシビリティツールは、デスティネーション情報を使用してユーザーが複雑な文書を効率的にナビゲートできるよう支援するため、適切なデスティネーション設定はインクルーシブなPDF開発において極めて重要です。

PDDestinationの理解は、他の形式から文書を移行または変換する際にも重要です。ナビゲーション構造を維持するには、ソース文書のリンクやブックマークをPDFデスティネーションオブジェクトに正確にマッピングする必要があるためです。デスティネーションの実装が不適切だと、ナビゲーションの破損、ユーザーエクスペリエンスの混乱、またはアクセシビリティコンプライアンスの失敗につながる可能性があります。

• PDPageDestination – 特定のフィットタイプとパラメータを持つ明示的なページデスティネーションを表すPDDestinationの具象サブクラス
• PDOutlineItem – ナビゲーションターゲットを指定するためにPDDestinationを使用するブックマークエントリクラス
• PDAnnotationLink – ナビゲーション用にPDDestinationオブジェクトを参照できるリンク注釈クラス
• PDPageFitDestination – ビューアウィンドウ内にページ全体を収めるデスティネーションタイプ
• PDAction – ユーザーインタラクションによってトリガーされ、デスティネーションにナビゲートする可能性のあるアクションを表す抽象クラス