PDActionThread

PDActionThreadは、Apache PDFBoxの高レベルPDModel 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 ) で定義されたPDF仕様の一部であり、記事スレッド（1つまたは複数のページの非連続的な領域にわたって流れるコンテンツアイテムのシーケンス）を通じたナビゲーションを可能にします。このクラスは、Javaの開発者に対して、PDFファイル内のスレッドナビゲーションアクションの読み取り、作成、変更をプログラムで行うためのアクセス手段を提供します。

PDActionThreadは、Apache PDFBoxにおける具象実装クラスであり、PDF標準で規定されているスレッドアクションタイプに対応しています。スレッドアクションにより、ユーザーはPDF文書内の複数の段組み、ページ、または非順次的な位置にまたがる記事をナビゲートできます。単純なページナビゲーションアクション（GoToアクションなど）とは異なり、スレッドアクションは文書レイアウト全体に物理的に分散している可能性があるコンテンツの論理的な読み取り順序を維持します。

このクラスはベースとなるPDActionクラスを拡張し、特定の記事スレッドをたどるか、次または前のスレッドビーズへの移動などのナビゲーションコマンドを定義するスレッド辞書を取得および設定するメソッドを提供します。これは、PDActionGoTo（特定の宛先にジャンプ）やPDActionURI（外部URIを開く）などのPDFBox内の他のアクションタイプとは異なり、PDActionThreadはスレッド化された記事コンテンツの構造化されたナビゲーションを専門的に処理します。

複雑なPDF文書を扱う開発者、特に雑誌スタイルのレイアウト、複数段組みの記事、または構造化された読み取りシーケンスを含む文書を扱う開発者にとって、PDActionThreadはアクセシブルで論理的なナビゲーションパターンを実装するための必須機能を提供します。スレッドアクションの理解と適切な実装は、 ( 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は複数ページにわたって複数段組みでコンテンツを表示する可能性がありますが、スレッドアクションにより、読者（およびスクリーンリーダー）は手動でナビゲートすることなく、各記事を最初から最後まで追うことができます。このような文書を作成または操作する開発者は、これらのナビゲーション構造をプログラム的に保持または確立するためにPDActionThreadを必要とします。

PDActionThreadは、PDFファイル構造内のスレッドアクションを表す基盤となるCosレベルの辞書オブジェクトをラップすることで動作します。インスタンス化されると、このクラスはスレッドアクションのプロパティ（ターゲットスレッドやそのスレッド内の特定のビーズ（コンテンツフラグメント）を含む）を取得および変更するためのアクセサメソッドを提供します。

主なワークフローは以下の通りです：

1. 既存のスレッドアクションへのアクセス：開発者は、スレッドナビゲーションをすでに含む注釈やアウトライン項目などのインタラクティブ要素からPDActionThreadオブジェクトを取得できます
2. スレッドターゲットの設定：このクラスは、スレッド辞書参照または特別なナビゲーションコマンド（最初、最後、次、前のビーズ）を使用して、ナビゲートする記事スレッドを指定できます
3. トリガーとの関連付け：スレッドアクションは通常、リンク注釈などのPDFインタラクティブ要素に付加され、ユーザーがクリックしてスレッド化されたコンテンツをナビゲートできるようにします
4. シリアライズ：PDActionThread APIを通じて行われた変更は、文書が保存されるときに基盤となるCosレベルのPDF辞書構造に書き戻されます

このクラスはPDThreadやPDThreadBeadなどの他の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 ) で規定されているように、ナビゲーションパスが文書の論理的なコンテンツフローと一貫性を保つことを保証します。

• PDAction – Apache PDFBoxにおけるすべてのPDFアクションタイプのベースクラス
• PDThread – PDF文書内の記事スレッドを表し、ビーズのシーケンスを含む
• PDThreadBead – 記事スレッド内の単一のコンテンツフラグメント（ビーズ）を表す
• PDAnnotationLink – ユーザーインタラクションのためにPDActionThreadなどのアクションを含むことができるリンク注釈
• PDModel API – PDF文書構造を扱うためのApache PDFBoxの高レベルAPI