BeginMarkedContentSequenceWithProperties

BeginMarkedContentSequenceWithPropertiesは、Apache PDFBox APIのクラスで、PDF文書内でプロパティ辞書を関連付けたマークされたコンテンツシーケンスを作成するための機能を開発者に提供します。この機能は、構造化されたPDFコンテンツの実装、特に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 BDC（Begin Marked Content）オペレーターへのプログラマティックなアクセスを提供します。

BeginMarkedContentSequenceWithPropertiesは、Apache PDFBoxのコンテンツストリームオペレータークラスであり、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 ) で定義されているBDCオペレーターにマッピングされます。このオペレーターは、マークされたコンテンツシーケンスを開始し、マークされたコンテンツに関するメタデータを含むプロパティ辞書と関連付けます。プロパティなしでマークされたコンテンツを作成するシンプルなBeginMarkedContentオペレーター（BMC）とは異なり、このクラスは開発者がプロパティ辞書を通じてコンテンツ領域に構造化された情報を付加することを可能にします。これらのプロパティ辞書は、Tagged PDF文書 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) に必要なアクセシビリティ情報、言語属性、構造的役割、その他のメタデータを指定できます。

このクラスは通常、2つのパラメーターを受け取ります。タグ名（マークされたコンテンツのタイプを識別）とプロパティオブジェクト（関連するメタデータを含む）です。この組み合わせにより、PDFコンテンツストリーム内にセマンティック構造を作成でき、段落、見出し、図、アーティファクトなど、異なるタイプのコンテンツを区別することが可能になります。

PDFのアクセシビリティと文書構造を扱う開発者にとって、BeginMarkedContentSequenceWithPropertiesは準拠したTagged PDF文書を作成するために不可欠です。Tagged PDFは、マークされたコンテンツシーケンスを使用して文書コンテンツの論理構造を定義し、支援技術が障害を持つユーザーに意味のある方法で情報を提示できるようにします。プロパティを持つマークされたコンテンツが適切に実装されていなければ、PDF文書はその構造に関するセマンティック情報を伝えることができず、スクリーンリーダーやその他の支援技術にとってアクセス不可能になります。

このクラスは、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文書をプログラマティックに生成または修正する際に特に重要です。開発者は、構造タグ、代替テキストの説明、言語仕様、その他のアクセシビリティ機能をPDFコンテンツストリームに直接埋め込むことができます。レポートジェネレーター、文書変換ツール、フォームビルダーなど、PDF生成を自動化するアプリケーションにとって、このクラスの適切な使用は、出力が法的なアクセシビリティ要件と業界のベストプラクティスを満たすことを保証します。

Apache PDFBoxでBeginMarkedContentSequenceWithPropertiesを使用する際、開発者はクラスのインスタンスを作成し、PDPageContentStreamに追加します。このクラスは、PDFコンテンツストリームにBDCオペレーターを書き込み、その後にタグ名とプロパティ辞書への参照を記述します。プロパティ辞書自体は通常、ページのResources辞書に格納され、コンテンツストリーム内で名前によって参照されます。

基本的なワークフローは次のとおりです：（1）必要なメタデータを含むプロパティ辞書を作成または取得する、（2）この辞書をページリソースに登録する、（3）タグ名とプロパティ参照を使用してBeginMarkedContentSequenceWithPropertiesをインスタンス化する、（4）マークするコンテンツの前にコンテンツストリームに追加する。マークされたコンテンツシーケンスは、有効なPDF構造を維持するために、対応するEndMarkedContentオペレーターで適切に閉じる必要があります。

プロパティ辞書には、マークされたコンテンツのタイプに応じて、さまざまなエントリを含めることができます。構造ツリー要素とのリンクのためのMCID（Marked Content Identifier）、言語仕様のためのLang、置換テキストのためのActualText、代替説明のためのAltなどが含まれます。これらのプロパティにより、PDFの論理構造ツリーがマークされたコンテンツを参照および記述でき、Tagged PDF文書 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) を定義するセマンティックレイヤーが作成されます。

• Tagged PDF – タグを通じて構造情報を含むPDF文書で、アクセシビリティとコンテンツの再利用を可能にする
• Marked Content – 構造的またはアクセシビリティ目的のために識別および分類されたPDFコンテンツストリームの一部
• Structure Tree – PDF文書の論理構造の階層表現で、構造要素をマークされたコンテンツにリンクする
• PDF Content Stream – PDFページ上のコンテンツの外観を記述するオペレーターとオペランドのシーケンス
• PDF/UA – 適切なタグ付けと構造を要求するアクセシブルなPDF文書のISO標準