Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

PDDefaultAttributeObject

PDDefaultAttributeObjectは、Apache PDFBoxライブラリの高レベルPDModel APIに含まれるJavaクラスで、PDF構造要素で使用されるデフォルト属性オブジェクトを表します。

カテゴリ: Java PDF APIs (Apache PDFBox)
キーワード: pddefaultattributeobject, PDDefaultAttributeObject

概要

PDDefaultAttributeObjectは、Apache PDFBoxライブラリの高レベルPDModel APIに含まれるJavaクラスで、PDF構造要素で使用されるデフォルト属性オブジェクトを表します。このクラスは、タグ付きPDF文書内の構造要素のデフォルトプロパティを定義する属性情報の読み取りと変更をプログラムで行うためのアクセスを提供します。これらは ( N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているアクセシビリティと文書の論理構造にとって不可欠です。

定義

PDDefaultAttributeObjectは、Apache PDFBox内の特定の実装クラスで、タグ付きPDFのコンテンツに対するデフォルトのフォーマットと構造プロパティを指定するために使用されるPDF属性オブジェクトを処理します。個々の構造要素に適用されるインライン属性とは異なり、デフォルト属性オブジェクトは複数の構造要素に継承可能なプロパティを定義することで、PDF構造ツリー内の冗長性を削減します。このクラスはPDFBoxの属性オブジェクト階層を拡張し、 ( N.A., (N.A.). (). 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プロセッサが文書コンテンツを解釈する方法を制御する属性ディクショナリへのアクセスと操作のためのメソッドを提供します。

このクラスは、構造要素自体ではなく属性オブジェクトを管理する点で、PDFBoxの他の構造要素クラスとは異なります。PDStructureElementのようなクラスが文書の論理構造ツリー内のノードを表すのに対し、PDDefaultAttributeObjectは ( , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) に従って、配置、レイアウト、セマンティック情報などのプロパティを記述する属性データに焦点を当てています。

重要性

アクセシブルなPDFや文書構造を扱う開発者にとって、PDDefaultAttributeObjectは以下の理由から重要です：

  • アクセシビリティコンプライアンス：適切な属性管理により、PDF文書がPDF/UAなどのアクセシビリティ標準を満たし、スクリーンリーダーや支援技術が依存する必要な構造情報を提供します
  • 効率的な構造管理：デフォルト属性を使用することで、複数の構造要素間で共通のプロパティを繰り返す代わりに一度だけ定義することで、ファイルサイズと複雑さを削減します
  • プログラムによる制御：開発者はこのクラスを使用して、Javaアプリケーションを通じてPDF文書を作成または修正する際に、属性オブジェクトの検査、検証、変更を行うことができます
  • 標準への準拠：このクラスは属性オブジェクトに関するPDF仕様の要件を実装し、生成された文書が ( N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 標準に準拠することを保証します

仕組み

PDDefaultAttributeObjectは、PDF仕様で定義された属性のキーと値のペアを含むCOS（Carousel Object Structure）ディクショナリをカプセル化することで機能します。PDFがPDFBoxによって解析されると、属性オブジェクトを参照する構造要素ディクショナリは、デフォルト属性用のPDDefaultAttributeObjectインスタンスを含む適切なJavaオブジェクトでラップされます。

開発者は標準的なPDFBoxパターンを通じてこのクラスとやり取りします：

  1. 属性の読み取り：クラスは、基礎となるCOSディクショナリから特定の属性値を取得するgetterメソッドを提供し、レイアウト属性、リスト属性、テーブル属性などのプロパティの検査を可能にします
  2. 属性の変更：setterメソッドにより属性値の変更が可能になり、基礎となるPDF構造を更新します
  3. 型の処理：クラスは属性オブジェクトの型と所有者情報を管理し、構造階層内での役割に応じて属性が適切に分類されることを保証します
  4. ディクショナリアクセス：便利メソッドでカバーされない高度な操作のために、基礎となるCOSDictionaryへの直接アクセスが可能です

属性オブジェクトはPDFBoxの広範な構造要素フレームワークと統合され、構造要素は属性オブジェクトを参照してデフォルトプロパティを継承できます。これは、 ( , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で概説されているように、属性をインラインで、クラスマップを通じて、または構造ツリーの全領域に適用されるデフォルト属性として指定できるというPDF仕様のモデルに従っています。

関連用語

  • PDStructureElement – タグ付きPDFの論理構造ツリー内の個々のノードを表すJavaクラス
  • Tagged PDF – アクセシビリティとコンテンツの再利用のための構造情報とセマンティック情報を含むPDF文書
  • COSDictionary – Carousel Object Structure内のPDFディクショナリオブジェクトを表すApache PDFBoxの低レベルクラス
  • PDF/UA – 適切な構造要素と属性の実装を必要とするアクセシブルなPDF文書のISO標準
  • Structure Tree – PDFファイル内の文書論理構造の階層的表現

出典

(N.A.) (2020)
(N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html
PDF Association (2023)
(). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/
(N.A.) (2014)
(N.A.). (). 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
gdoc_arrow_left_alt PDCryptFilterDictionary PDDestination gdoc_arrow_right_alt