PageMode

PageModeは、Apache PDFBox Java APIのクラスで、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 ) で定義されているドキュメントカタログ構造の一部であり、開発者が特定のドキュメントタイプに最適化されたユーザーエクスペリエンスを提供できるようにします。

PageModeは、Apache PDFBoxの列挙型クラスで、PDFドキュメントのカタログ辞書内のページモードエントリを表します。ページモードは、PDFを開いた際の初期表示状態を指定し、デフォルトで表示されるナビゲーションパネルや補助ウィンドウを制御します。一般的なページモードには、ドキュメントコンテンツのみを表示するモード（UseNone）、アウトライン/ブックマークパネルを表示するモード（UseOutlines）、ページサムネイルを表示するモード（UseThumbs）、添付ファイルを表示するモード（UseAttachments）、またはフルスクリーンモードでドキュメントを表示するモード（FullScreen）が含まれます。ページの配置方法（単一ページ、連続スクロール、見開きページ）を制御するページレイアウト設定とは異なり、PageModeは具体的にどの補助的なインターフェース要素を表示するかを制御します。この区別は重要です。PageModeはビューアのクロームとナビゲーション補助機能に影響を与えますが、ページレイアウトはドキュメントページ自体の空間的配置を決定します。

PageModeを正しく理解して実装することで、ドキュメントのアクセシビリティと使いやすさが向上します。技術マニュアルや構造化されたレポートのような複雑なナビゲーション構造を持つドキュメントの場合、PageModeをUseOutlinesに設定することで、ブックマークパネルが自動的に表示され、ユーザーがタグ付けされたコンテンツ ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) を効率的にナビゲートできるようになります。PDFポートフォリオや重要な添付ファイルを含むドキュメントの場合、UseAttachmentsモードを使用することで、ユーザーが利用可能なファイルをすぐに確認できます。アクセシビリティ重視のアプリケーションは、適切なPageMode設定から特に恩恵を受けます。これらの設定により、支援技術を使用するユーザーを、ドキュメントのタグ構造を補完する重要なナビゲーション機能へと誘導できるためです ( 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 ) 。PageMode設定を無視する開発者は、機能的には完全なPDFを作成しても、便利なナビゲーションツールを非表示にすることで、最適とは言えないユーザーエクスペリエンスを提供してしまう可能性があります。

Apache PDFBoxでは、開発者は通常、PDDocumentクラスとPDDocumentCatalogクラスを通じてPageModeを操作します。ページモードを設定するには、まずドキュメントカタログを取得し、次に定義済みのPageMode列挙値の1つを指定してsetPageMode()を呼び出します。この列挙型には、USE_NONE、USE_OUTLINES、USE_THUMBS、FULL_SCREEN、USE_OPTIONAL_CONTENT、USE_ATTACHMENTSなどの定数が含まれています。特定のPageModeで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 ) に従ってカタログ辞書の/PageModeエントリに書き込まれます。互換性のあるPDFビューアは、このエントリを読み取り、ドキュメントを開く際にインターフェースを適切に調整します。たとえば、構造化されたブックマーク階層を持つドキュメントでPageMode.USE_OUTLINESを設定すると、ナビゲーションペインが自動的に開き、ドキュメントの論理構造がユーザーに即座にアクセス可能になります。

• PDDocumentCatalog – PDFのカタログ辞書を表すApache PDFBoxクラスで、PageMode設定を含むドキュメントレベルのメタデータが格納されています
• Page Layout（ページレイアウト） – 表示するインターフェース要素ではなく、ページの配置方法（単一、連続、見開き）を制御する、関連するPDF表示設定
• Document Outline（ドキュメントアウトライン） – PageMode.USE_OUTLINESによってデフォルトで表示される階層的なブックマーク構造（ブックマークとも呼ばれます）
• PDF Catalog Dictionary（PDFカタログ辞書） – PageModeエントリを含むドキュメントレベルの情報を格納する、PDFファイルのルート構造
• Viewer Preferences（ビューア設定） – ドキュメントの表示方法を制御する追加のPDF設定で、ツールバー、ウィンドウサイズ、その他のインターフェース動作のオプションを提供し、PageModeを補完します