PDListAttributeObject

PDListAttributeObjectは、Apache PDFBoxライブラリの高レベルPDModel APIに含まれる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 ) で定義されているリスト関連の構造属性にプログラムでアクセスし、操作することができます。PDFファイルのアクセシビリティと意味的構造を適切に維持するために重要な役割を果たします。

PDListAttributeObjectは、PDF仕様で定義されているリスト属性オブジェクトに対応するApache PDFBox内の特殊なクラスです。PDFBoxの属性オブジェクト階層を拡張し、タグ付きPDFのリスト構造（順序付きリストや順序なしリストなど）に特に関連する属性へのタイプセーフなアクセスを提供します。汎用的な属性辞書とは異なり、PDListAttributeObjectはリスト番号形式や継続情報などのリスト固有のプロパティを設定・取得するための専用メソッドを提供します。このクラスは、 ( 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構文の上に、より高レベルなオブジェクト指向インターフェースを提供するPDModelレイヤーの一部です。

このクラスは、構造要素自体ではなく属性オブジェクトを特に扱う点で、他のPDFBox構造クラスとは異なります。構造要素が文書の論理的階層を定義するのに対し、PDListAttributeObjectのような属性オブジェクトは、それらの構造がどのように解釈・レンダリングされるべきかについての追加的な意味情報を提供します。

アクセシブルなPDFやタグ付きコンテンツを扱う開発者にとって、PDListAttributeObjectは、PDF/UA ( 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ドキュメントをプログラムで作成または修正する際、このクラスにより開発者は、リストが前のリストから継続するかどうか、どの番号付けシステムを使用すべきか、その他視覚的表示と意味的意義の両方に影響を与えるメタデータなど、重要なリスト特性を指定できます。適切なリスト属性がないと、文書はアクセシビリティ検証に失敗したり、スクリーンリーダーやその他の支援技術に依存するユーザーにとって劣化した体験を提供する可能性があります ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 。

PDListAttributeObjectは、PDF文書内のリスト構造要素に関連付けられた属性辞書をカプセル化することで機能します。PDFを読み込む際、PDFBoxは基礎となる辞書構造を解析し、リスト固有の属性に対する便利なgetterおよびsetterメソッドを提供するPDListAttributeObjectインスタンスを生成します。

このクラスが管理する主要な属性には以下が含まれます：

ListNumbering：順序付きリストに使用される番号付けシステムを定義します（例：10進数、大文字ローマ数字、小文字アルファベット）

Continuations：リストが前のリストから番号付けを継続するか、新たに開始するかを指定します

このクラスはPDFBoxの構造ツリーAPIと統合されており、開発者は適切な構造要素にリスト属性を添付できます。タグ付きPDFを作成する際、開発者はPDListAttributeObjectをインスタンス化し、setterメソッドを使用してそのプロパティを構成し、タグ付きPDF仕様 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で定義されているリスト構造要素（L、LI、Lbl、またはLBodyタグ）に関連付けます。

基礎となる実装は、文書が保存される際にこれらのJavaオブジェクトをPDF辞書構文に逆シリアル化する処理を行い、結果として得られるPDFファイルがPDF仕様に準拠した適切にフォーマットされた属性辞書を含むことを保証します。

• PDStructureElement – PDFの論理構造ツリー内の構造要素を表現するJavaクラス
• Tagged PDF – アクセシビリティとコンテンツ再利用のための構造情報を含むPDF文書
• PDFBox PDModel – PDFドキュメントオブジェクトを扱うためのApache PDFBoxの高レベルAPIレイヤー
• Structure Attributes（構造属性） – 意味情報を提供する構造要素に添付される追加プロパティ
• PDF/UA – 適切な構造タグ付けを要求するアクセシブルなPDF文書のISO標準