PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE

PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODEは、Apache PDFBoxのPDViewerPreferencesクラスに含まれる定数で、ユーザーがフルスクリーンモードを終了した際の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ビューアーの表示動作を制御できるようにします。この定数は、フルスクリーンモードから通常の表示モードへ移行する際に、どのナビゲーションパネルやページレイアウトを表示するかを決定します。

PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODEは、Apache PDFBoxの高レベルPDModel API内のJava列挙型または定数値で、PDFのViewerPreferencesディクショナリ内のNonFullScreenPageModeエントリを表します。 ( 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ビューアーが何を表示するかを制御します。指定可能な値には、UseNone（文書のアウトラインもサムネイル画像も表示しない）、UseOutlines（文書のアウトラインを表示）、UseThumbs（サムネイル画像を表示）、UseOC（オプションコンテンツグループパネルを表示）が含まれます。

この定数は、初期表示や一般的な表示動作を制御するのではなく、フルスクリーン表示から通常モードへの移行状態を特に扱う点で、他のビューアー設定とは異なります。この設定は、PDFがフルスクリーンモードで開かれ、その後ユーザーがそのモードを終了した場合にのみ有効になります。

PDF生成や操作アプリケーションを開発する開発者にとって、NON_FULL_SCREEN_PAGE_MODEを理解し適切に実装することは、いくつかの理由で重要です。

ユーザーエクスペリエンスの制御: この設定を行うことで、開発者はユーザーがプレゼンテーションモードやスライドショーモードを終了する際に、一貫性のある直感的なナビゲーション体験を提供でき、異なる表示状態においても文書の使いやすさとアクセシビリティを維持できます。

プレゼンテーションアプリケーション: プレゼンテーションPDFやスライドショー形式の文書を生成するアプリケーションは、フルスクリーン後の動作を制御することで恩恵を受けます。これにより、ユーザーがプレゼンテーションモードを終了した後、手動でパネルを調整することなく文書を簡単にナビゲートできます。

アクセシビリティへの配慮: NON_FULL_SCREEN_PAGE_MODEを含むビューアー設定を適切に構成することで、ナビゲーション補助機能を必要とするユーザーがそれらを利用できるようにすることで文書のアクセシビリティを向上させ、 ( 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 ) で参照されているアクセシビリティのベストプラクティスに準拠できます。

Apache PDFBoxでPDViewerPreferences.NON_FULL_SCREEN_PAGE_MODEを使用する場合、開発者はPDF文書のカタログに関連付けられたPDViewerPreferencesオブジェクトを操作します。実装は次の技術的な流れに従います。

設定の指定: 開発者はPDDocumentを通じて文書カタログにアクセスし、PDViewerPreferencesオブジェクトを取得または作成し、適切な定数を使用してnon-full-screen page modeを設定します。PDFBox 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 ) で指定されているPDFのViewerPreferencesディクショナリ内の対応する名前値に変換します。

値のマッピング: この定数は、4つのPDF名前値のいずれかにマップされます：/UseNone（パネルなし）、/UseOutlines（ブックマークパネル）、/UseThumbs（サムネイルパネル）、/UseOC（レイヤーパネル）。各値は、フルスクリーンモードを終了する際にインターフェースをどのように構成するかを、準拠したPDFビューアーに指示します。

ビューアーによる解釈: ユーザーがPDFをフルスクリーンモードで開き、その後終了すると、PDFビューアーはViewerPreferencesディクショナリからNonFullScreenPageMode値を読み取り、それに応じて表示を調整します。すべてのビューアーがすべての設定をサポートしているわけではありませんが、ほとんどの最新のPDFアプリケーションはこれらの標準設定を尊重します。

コード実装: PDFBoxでは、一般的な使用方法として、PDViewerPreferencesインスタンスでsetNonFullScreenPageMode()のようなメソッドを呼び出し、希望する定数値を渡してから、変更されたPDF文書を保存して設定を永続化します。

• PDViewerPreferences – 表示モード、印刷オプション、ナビゲーション動作を含むPDFビューアー設定を管理するためのApache PDFBoxクラス
• PDDocument – PDF文書全体を表すPDFBoxのコアクラスで、カタログ、ページ、文書レベルのプロパティへのアクセスを提供
• PDDocumentCatalog – 文書構造情報とビューアー設定を含むPDFカタログディクショナリのPDFBox表現
• Full-Screen Mode – メニュー、ツールバー、ウィンドウコントロールなしで文書が画面全体を占有するPDF表示状態で、通常プレゼンテーションに使用される
• ViewerPreferences Dictionary – 仕様で定義されているPDF構造で、準拠するリーダーが文書をどのように表示すべきかの設定を保存する