PageLayout

PageLayoutは、Apache PDFBox Java APIにおいて、PDFビューアでドキュメントを開いたときのPDFページの表示方法を表現・制御するクラスです。これはPDFドキュメントのカタログディクショナリ内のPageLayoutエントリに対応しており、 ( 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 ) で規定されている初期ページ表示配置を定義します。このクラスは、単一ページ、連続スクロール、見開き表示などの標準的なレイアウトモードを取得・設定するメソッドを提供します。

PageLayoutは、Apache PDFBoxにおける列挙型スタイルのクラスで、PDF仕様で利用可能な様々なページレイアウトオプションをカプセル化します。ページレイアウトは、PDFを最初に開いたときの視覚的な表示モードを決定します。ページを一度に一つずつ表示するか、連続した縦列で表示するか、あるいは書籍の見開きのように向かい合わせで表示するかを指定します。PDFBoxでは、このクラスはSinglePage、OneColumn、TwoColumnLeft、TwoColumnRight、TwoPageLeft、TwoPageRightなどの標準レイアウト値を表す型安全な定数を提供します。どのパネル（ブックマーク、サムネイル）を表示するかを制御するページモード設定とは異なり、PageLayoutは ( 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生成や操作を行う開発者にとって、PageLayoutはドキュメントを開いたときの初期ユーザー体験を制御するために極めて重要です。適切なページレイアウトを設定することでドキュメントの使いやすさが向上します。例えば、雑誌スタイルの出版物には2カラムレイアウト、個別に表示すべきフォームには単一ページモード、長い物語文書には連続スクロールを使用するなどです。これはアクセシブルな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 ) 。PageLayoutを理解することで、開発者はドキュメントの意図された目的に合致し、読者の理解を向上させる表示設定をプログラム的に設定できます。

Apache PDFBoxにおいて、PageLayoutクラスはJava定数をPDF仕様のカタログディクショナリで定義された文字列値にマッピングすることで機能します。PDFドキュメントを作成または変更する際、開発者はPDDocument.getDocumentCatalog()を通じてドキュメントカタログにアクセスし、setPageLayout()のようなメソッドを使用して望ましいレイアウトモードを指定します。PageLayout定数は、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名前オブジェクトに変換されます。例えば、PageLayout.TWO_COLUMN_LEFTはPDF名前"/TwoColumnLeft"に対応し、ビューアに対して奇数ページを左側に配置した2カラム形式でページを表示するよう指示します。PDFを開くと、準拠したビューアはこのカタログエントリを読み取り、それに応じて初期表示を配置します。ただし、ユーザーは通常、ビューアのインターフェースを通じてこの設定を上書きできます。

• PDDocument – Apache PDFBoxにおいてPDFドキュメントを表すメインクラス
• Document Catalog – ドキュメントレベルの設定を含むPDFの論理構造のルートオブジェクト
• PageMode – PDFを開いたときにどのナビゲーションパネル（サムネイル、ブックマーク）を表示するかを制御
• PDFBox – PDFドキュメントの作成と操作のためのオープンソースJavaライブラリ
• Viewer Preferences – PDFがビューアアプリケーションでどのように表示されるかを制御する設定の集合