PDPageFitDestination

PDPageFitDestinationは、Apache PDFBoxライブラリのJavaクラスで、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ページがどのように表示されるかを制御するナビゲーションターゲットをプログラム的に作成または操作できます。

PDPageFitDestinationは、Apache PDFBoxのPDModelパッケージ内の具象実装クラスで、PDF仕様で利用可能な複数の目的地タイプの1つを表します。特定の座標やズームレベルでページを配置する他の目的地タイプとは異なり、PDPageFitDestination実装は、ページ全体、その幅、その高さ、または特定の矩形領域を表示ウィンドウ内にフィットさせるために倍率と位置を調整します。このクラスはPDDestinationを継承し、ナビゲート先のページとそのページをビューア内でどのようにフィットさせるかを指定するメソッドを提供します。一般的なフィットタイプには、ページ全体をウィンドウにフィットさせる（Fit）、ページ幅をウィンドウ幅にフィットさせる（FitH）、ページ高さをウィンドウ高さにフィットさせる（FitV）、特定のバウンディングボックスをフィットさせる（FitR）などがあります。

PDFドキュメントを扱う開発者にとって、PDPageFitDestinationはPDFビューア内で直感的なナビゲーション体験を作成するための重要な機能を提供します。内部リンク、ブックマーク、目次エントリを含むインタラクティブな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目的地構文の複雑さを抽象化し、開発者が低レベルのPDF構造を手動で構築することなく、洗練されたナビゲーション機能を実装できるようにします。

PDPageFitDestinationは、 ( 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目的地配列を作成するために必要なパラメータをカプセル化することで動作します。インスタンス化時に、開発者はターゲットページを表すPDPageオブジェクトとフィットタイプ定数を指定します。その後、クラスはPDFビューアがページを正しくナビゲートして表示するために解釈する適切な目的地配列を構築します。例えば、FitH目的地にはページ参照と垂直座標が含まれており、ビューアはページ幅をウィンドウ幅にフィットさせ、ページの上部を指定された垂直位置に配置します。PDFBoxライブラリは、これらの高レベルJavaオブジェクトと、実際にPDFファイルに書き込まれる低レベルのCOSArray構造との間の変換を処理します。開発者は、これらの目的地をPDAnnotationLinkオブジェクトなどのインタラクティブ要素、アウトライン項目（ブックマーク）にアタッチしたり、ドキュメントが開かれたときの初期表示を決定するオープンアクションとして使用したりできます。

• PDDestination – PDFドキュメント内のすべてのタイプのナビゲーション目的地を表す親クラス
• PDPageDestination – 正確なXYZ座標とズームレベルを指定する目的地の関連クラス
• PDAnnotationLink – PDFページ内でクリック可能なリンクを作成するために目的地を使用する注釈クラス
• PDOutlineItem – PDFの特定の場所にナビゲートするために目的地を使用するブックマークエントリクラス
• PDPage – 目的地のターゲットとして機能するPDFドキュメント内の個別ページを表すクラス