PDDocumentOutline

PDDocumentOutlineは、Apache PDFBoxライブラリに含まれるJavaクラスで、PDFファイルの文書アウトライン（ブックマークとも呼ばれる）を表現します。この高レベルAPIコンポーネントにより、開発者は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 ) においてオプションのナビゲーション機能として定義されており、ユーザーのアクセシビリティと文書の使いやすさを向上させます。特に ( 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において重要です。

PDDocumentOutlineは、Apache PDFBoxのPDModelパッケージに含まれるクラスで、PDF文書のアウトライン辞書をカプセル化します。COS（Carousel Object Structure）オブジェクトを直接操作する低レベルクラスとは異なり、PDDocumentOutlineはブックマーク階層を操作するための開発者に優しいインターフェースを提供します。このクラスはアウトラインのツリー構造のルートを表し、最上位のアウトライン項目（PDOutlineItemオブジェクト）への参照を保持します。これらの項目自体が子項目を含むことができ、ネストされたナビゲーション構造を形成します。この点で、ページコンテンツやインタラクティブ要素を扱うPDPageやPDAnnotationなどの他のPDFBoxクラスとは異なり、文書レベルのナビゲーションメタデータを専門的に処理します。

文書アウトラインは、 ( 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/UA-1では、支援技術のための適切なナビゲーション構造が要求されます。PDFBoxを使用する開発者にとって、PDDocumentOutlineは目次機能を実装するための主要なインターフェースを提供し、ユーザーが大きな文書を素早くナビゲートできるようにします。この機能は、レポート、技術文書、電子書籍をプログラムで生成する際に特に重要です。文書構造から自動的にブックマークを生成することで、ユーザーエクスペリエンスが大幅に向上します。さらに、多くのPDFワークフローでは、文書処理操作中に既存のブックマークを保持または変更する必要があります。

PDDocumentOutlineクラスは、文書のブックマーク階層のコンテナとして機能し、PDDocument.getDocumentCatalog().getDocumentOutline()メソッドを通じてアクセスされます。開発者はPDDocumentOutlineをインスタンス化して新しいアウトラインを作成し、個々のブックマークを表すPDOutlineItemオブジェクトで構成できます。各アウトライン項目は、タイトル、目的ページ、視覚的外観（色、フォントスタイル）、およびネスト構造のための子項目を指定できます。このクラスは、項目が追加または削除される際に、アウトライン項目間の双方向リンク（親子関係および兄弟関係）を自動的に維持します。PDFが保存されると、PDFBoxは ( 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辞書形式にアウトライン構造をシリアライズし、すべての標準PDFリーダーとの互換性を保証します。

• PDOutlineItem – 文書アウトライン内の個別のブックマークエントリで、タイトル、目的地、子ブックマークを含むことができます
• PDDocument – メモリ内のPDF文書全体を表すApache PDFBoxの最上位クラスです
• PDDocumentCatalog – PDF文書のオブジェクト階層のルートオブジェクトで、アウトラインを含む主要な文書構造への参照を保持します
• PDDestination – アウトライン項目やリンクがナビゲートできるPDF内のターゲット位置を表すクラスです
• PDPage – PDF文書内の個別のページを表すクラスで、通常、アウトライン項目が目的地として参照します