PDRadioButton

PDRadioButtonは、Apache PDFBoxの高レベルPDModel APIにおいて、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文書内のラジオボタンフォームフィールドをプログラム的に読み取り、作成、変更するためのメソッドを提供します。

PDRadioButtonは、PDFBoxのフォームフィールド階層を拡張してラジオボタンウィジェットを専門的に扱う特化されたフォームフィールドクラスです。複数のオプションを独立して選択できるチェックボックスとは異なり、ラジオボタンは相互排他性を強制します—ラジオボタングループ内では常に1つのボタンのみを選択できます。このクラスは、基盤となるPDFディクショナリ構造をカプセル化し、選択された値、利用可能なオプション、外観状態、ウィジェットアノテーションなどのプロパティを操作するためのJavaフレンドリーなAPIを提供します。PDRadioButtonは、 ( 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 ) で定義されているAcroForm（インタラクティブフォーム）構造と連携して動作し、これはPDF文書内に入力可能なフォームを作成するための標準メカニズムです。

インタラクティブなPDFフォームを扱う開発者にとって、PDRadioButtonは、アンケート、申請書、設定フォームなど、単一選択を必要とするアクセシブルでユーザーフレンドリーな文書を作成するために不可欠です。適切に実装されたラジオボタンは、 ( 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構文ではなくビジネスロジックに集中できるようにします。PDRadioButtonの理解は、紙のフォームをデジタル形式に移行する場合や、自動フォーム入力ソリューションを構築する場合に特に重要です。

PDRadioButtonは、共通のフィールド名とエクスポート値を共有するウィジェットアノテーションのグループを管理することで動作します。ユーザーまたはアプリケーションがグループ内の1つのラジオボタンを選択すると、PDFBoxは自動的にそのグループ内の他のすべてのボタンの選択を解除し、フィールドの値（/Vエントリ）を更新し、各ウィジェットの外観状態（/ASエントリ）を調整します。各ラジオボタンオプションは、一意の外観状態名を持つ個別のウィジェットアノテーションで表現され、通常はエクスポート値の命名規則に従います。このクラスは、現在選択されている値を設定および取得し、利用可能なオプションを列挙し、個々のウィジェットプロパティにアクセスするためのメソッドを提供します。開発者は、PDRadioButtonをインスタンス化し、PDFのAcroFormに追加し、各オプション用の個別のウィジェットを作成し、それらを親フィールドに関連付けることで、新しいラジオボタングループを作成できます。ラジオボタンの外観（チェック/未チェック状態）は外観ストリームによって制御され、PDFBoxは自動的に生成することも、開発者が特定の視覚要件に合わせてカスタマイズすることもできます。

• PDAcroForm – PDF文書内のすべてのインタラクティブフォームフィールドの最上位コンテナ
• PDCheckBox – 複数の独立した選択を可能にするチェックボックスコントロールのフォームフィールドクラス
• PDField – Apache PDFBoxにおけるすべてのPDFフォームフィールドタイプの基底クラス
• PDAppearanceStream – フォームウィジェットの状態の視覚的表現を定義
• PDAnnotationWidget – PDFページ上のフォームフィールドに視覚的インターフェースを提供するアノテーションタイプ