PDPageFitHeightDestination

PDPageFitHeightDestinationは、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 ) において、デスティネーションオブジェクト構文の一部として定義されています。このデスティネーションが呼び出されると、ページの垂直方向の全範囲が表示されるようにズームレベルが調整されます。これは、PDF文書のナビゲーション機能において特に有用です。

PDPageFitHeightDestinationは、Apache PDFBoxの高レベルPDModel API内の具象実装クラスで、 ( 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 ) で定義されている「FitV」（Fit Vertically、垂直方向に合わせる）デスティネーションタイプに対応します。このクラスを使用することで、開発者はプログラムによってデスティネーションを作成、読み取り、または変更することができ、PDFページがビューアーのウィンドウ内に高さ全体を収めるように自動的にスケールされる一方で、特定の水平位置を維持します。FitWidthやFitRectangleなどの他のデスティネーションタイプとは異なり、FitHeightデスティネーションはページの垂直方向の全体をユーザーが確認できることを保証します。これは、横向きのドキュメントや垂直方向のコンテンツの可視性が重要な場合に特に有用です。このクラスはPDDestination基底クラスを拡張し、デスティネーションがアクティブ化されたときにページを配置する水平座標（左位置）を取得および設定するメソッドを提供します。

PDFのナビゲーションとユーザーエクスペリエンスに取り組む開発者にとって、PDPageFitHeightDestinationは文書がユーザーに表示される方法を制御するための重要な機能を提供します。このクラスにより、目次エントリ、ブックマーク、ハイパーリンクなど、ナビゲート時に読者がページの垂直方向の全体像を確認できるようにする、より直感的なナビゲーションシステムを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を作成する際にも有用です。画面の寸法に関係なくコンテンツの可視性を確保しながら、読書フローのために指定された水平位置を維持します。

PDPageFitHeightDestinationは、デスティネーションがアクティブ化されたときにPDFビューアーがビューを調整するために使用するデスティネーションパラメータをエンコードすることで機能します。開発者がApache PDFBoxを使用してこのクラスのインスタンスを作成する場合、対象ページオブジェクトとオプションで水平座標（「left」パラメータ）を指定します。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 ) では、FitVデスティネーションにはページ参照、デスティネーションタイプ識別子、および左座標値（または現在の水平位置を変更しない場合はnull）が含まれると定義されています。PDFビューアーがこのデスティネーションを処理する際（ブックマークのクリック、リンクのアクティブ化、またはプログラムによるナビゲーションを通じて）、対象ページの高さ全体を表示するための適切なズームレベルを計算し、コンテンツの左端を指定された水平座標に配置します。開発者は、getPage()、getLeft()、setLeft()などのPDFBoxメソッドを使用してこれらのデスティネーションプロパティを読み取りまたは変更でき、ライブラリは文書の読み取りおよび書き込み操作中に基礎となるPDFディクショナリ構造との間のシリアライゼーションを処理します。

• PDDestination – Apache PDFBoxにおけるすべてのデスティネーションタイプの抽象基底クラス
• PDPageFitWidthDestination – ページの幅全体を表示ウィンドウ内に収めるデスティネーションクラス
• PDOutlineItem – ナビゲーション対象としてデスティネーションを一般的に使用するブックマークエントリクラス
• PDAnnotationLink – デスティネーションを参照できるクリック可能なリンクを表すアノテーションクラス
• Named Destinations – 直接オブジェクト参照ではなく文字列名でデスティネーションを参照できるPDF機能