PDPageDestination

PDPageDestinationは、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内の特定のビューまたは場所を定義します。このクラスは、PDFデスティネーションオブジェクトを操作するための高レベルなJavaインターフェースを提供し、開発者がプログラムによって文書ナビゲーションターゲットを作成、読み取り、変更できるようにします。

PDPageDestinationは、Apache PDFBoxの抽象基底クラスで、PDFデスティネーションの概念をカプセル化します。デスティネーションとは、文書内の特定の場所とビューを指すポインタです。ページ番号のみを識別する単純なページ参照とは異なり、デスティネーションは、ターゲットページ、ビュータイプ（幅に合わせる、高さに合わせる、XYZ座標など）、ズーム倍率を含む完全なビュー仕様を提供します。PDPageDestinationは、PDPageFitDestination、PDPageXYZDestination、PDPageFitWidthDestinationなどの特定のデスティネーションタイプの親クラスとして機能し、それぞれがPDF仕様で定義された異なるビューフィッティングモードに対応しています。このクラスは、動作を定義するアクションオブジェクト（PDActionなど）とは異なり、リンク、ブックマーク、または文書アウトラインエントリから参照できる静的な表示場所を具体的に定義します。

PDFナビゲーション機能を扱う開発者にとって、PDPageDestinationは、文書内部リンクの実装、目次機能の作成、アクセシブルなナビゲーション構造の構築に不可欠です。このクラスの理解は、 ( 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デスティネーション配列の複雑さを抽象化し、開発者がPDF構文を直接操作するのではなく、型安全なJavaオブジェクトで作業できるようにします。これにより、大きな文書内の特定の場所にユーザーを確実にナビゲートするブックマーク、ハイパーリンク、アウトラインエントリを簡単に作成できます。

PDPageDestinationは、ページ参照とそれに続く表示モードを定義する名前およびオプションのパラメータで構成されるPDFデスティネーション配列をラップすることで機能します。開発者がPDPageDestinationサブクラスのインスタンスを作成すると、PDFBoxライブラリは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配列構造に変換します。たとえば、特定のx、y座標とズームレベルを持つPDPageXYZDestinationを作成すると、ページオブジェクト参照と指定されたパラメータを持つXYZ表示モードを含むデスティネーション配列が生成されます。クラス階層により、タイプ固有のメソッドが可能になります。PDPageFitWidthDestinationは上部位置のメソッドを提供し、PDPageFitRectangleDestinationは矩形座標を受け入れます。デスティネーションは、注釈（リンク注釈など）、アウトラインアイテム（ブックマーク）に添付したり、文書全体で文字列識別子によってアクセス可能な名前付きデスティネーションとして使用したりできます。PDFビューアがこれらのデスティネーションを処理すると、指定されたページに移動し、表示パラメータを適用して、一貫したユーザーナビゲーション体験を作成します。

• PDAction – PDF文書でユーザーインタラクションによってトリガーされるアクションを表すクラスで、デスティネーションを参照するGoToアクションを含むことができます
• PDOutlineItem – ブックマークまたはアウトラインエントリのクラスで、PDPageDestinationを使用してブックマークのナビゲーション先を定義します
• PDAnnotationLink – ナビゲーションターゲットにデスティネーションまたはアクションを使用するクリック可能なリンクを表す注釈クラス
• PDPage – 個々のPDFページを表すコアクラスで、PDPageDestinationオブジェクトのターゲットとして機能します
• Named Destinations – 直接オブジェクト参照ではなく名前でデスティネーションを参照できるようにするPDF機能で、PDPageDestinationを通じてアクセス可能です