PDPageFitWidthDestination

PDPageFitWidthDestinationは、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 ) で定義されている「FitH」宛先タイプを実装しており、特定の垂直位置を維持しながら、ページの幅をウィンドウ幅に合わせてスケーリングして表示します。PDFBoxの高レベルPDModel APIの一部として、PDFのナビゲーションとリンク動作をプログラムで管理するために使用されます。

PDPageFitWidthDestinationは、ページの幅をビューアウィンドウに合わせる宛先を作成または操作するために、PDFBoxの宛先階層を拡張した具象実装クラスです。ユーザーがこの宛先タイプを使用したリンクやブックマークをたどると、PDFビューアは自動的にズームレベルを調整し、対象ページの幅全体が水平方向に表示領域を満たすようにしながら、指定された上部座標にページを配置します。

この宛先タイプは、他のPDFBox宛先クラス（ページ全体を合わせるPDPageFitDestinationや、明示的なズームと位置指定を使用するPDPageXYZDestination）とは異なります。PDPageFitWidthDestinationは特に水平方向の調整を優先するため、テキスト列やコンテンツの範囲を水平スクロールなしで完全に表示できるようにするのに最適です。

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 ) では、これはFitH宛先配列形式に対応しており、ページ参照、キーワード「FitH」、およびページを表示する垂直位置を示すtopパラメータで構成されます。

PDFのナビゲーション、ブックマーク、リンクを扱う開発者にとって、PDPageFitWidthDestinationは、ユーザーが文書の異なるセクションにジャンプする際のコンテンツ表示方法を制御するための重要な機能を提供します。これは特に以下の点で重要です：

• アクセシビリティ: 適切な宛先設定により、文書リンクをたどるユーザーに最適なサイズでコンテンツが表示され、 ( 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文書をプログラムで生成します

PDPageFitWidthDestinationは、ページの表示方法をビューアに指示するPDF宛先配列を作成または読み取ることで動作します。Javaコードでインスタンス化する際、このクラスは2つの主要なパラメータを必要とします：

1. ページ参照: 文書内のどのページを表示するかを示すPDPageオブジェクト
2. 上部位置: ページ上で表示領域の上部を配置する垂直座標（ユーザー空間単位）を指定するfloatまたはinteger値

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構造は、明示的な宛先配列形式[page /FitH top]を使用します。ここで「page」はページオブジェクトへの間接参照、「/FitH」は宛先タイプキーワード、「top」は垂直座標です。PDPageFitWidthDestinationは、この配列形式の作成と解析を処理し、低レベルのPDF構文をオブジェクト指向のJavaインターフェイスに抽象化します。

開発者は通常、PDOutlineItemオブジェクト（ブックマーク）、PDAnnotationLinkオブジェクト（クリック可能なリンク）、またはPDF文書内の名前付き宛先を含むPDActionオブジェクトを作成する際に、このクラスを使用します。

• PDDestination – Apache PDFBoxにおけるすべての宛先タイプの抽象基底クラス
• PDPageXYZDestination – 明示的な座標とオプションのズームレベルでページを表示する宛先クラス
• PDPageFitDestination – ページ全体を表示ウィンドウ内に合わせる宛先クラス
• PDOutlineItem – ナビゲーションに宛先オブジェクトを一般的に使用するブックマークエントリクラス
• PDAnnotationLink – 対象位置を定義するために宛先を使用するインタラクティブリンク注釈