Checkbox
チェックボックスは、PDF文書における特定のボタンフィールドのサブタイプであり、ユーザーがオン(チェック済み)とオフ(未チェック)の2つの状態を切り替えることができます。
チェックボックスは、PDF文書における特定のボタンフィールドのサブタイプであり、ユーザーがオン(チェック済み)とオフ(未チェック)の2つの状態を切り替えることができます。 ( 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フォーム内で二者択一の選択を可能にするインタラクティブなフォーム要素です。入力可能なPDF文書において、はい/いいえの質問、オプション選択、確認の承認などに一般的に使用されます。
チェックボックスは、PDF構造内で特定のアピアランスストリームとエクスポート値を通じて内部的に表現される、2つの明確な状態を持つボタンフィールドウィジェットです。通常グループ内で一度に1つのオプションのみを選択できるラジオボタンとは異なり、チェックボックスは独立して動作します。各チェックボックスは、フォーム内の他のチェックボックスに影響を与えることなく、個別にオン・オフを切り替えることができます。チェックボックスの状態は、フォームフィールドの値に保存され、通常「Yes」や「Off」などの値を使用してチェック済み状態と未チェック状態を表現します。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 ) では、チェックボックスは技術的にプッシュボタンフラグがfalseに設定されたボタンフィールドとして実装され、状態を維持するのではなくアクションをトリガーする標準的なプッシュボタンと区別されます。
PDFフォームを作成または処理する開発者にとって、チェックボックスの理解は、ユーザーフレンドリーなデータ収集インターフェースを実装するために不可欠です。チェックボックスは、ユーザーが複数の選択を行ったり、利用規約への同意を示したりするための直感的な方法を提供します。 ( 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のチェックボックスは、いくつかの主要なコンポーネントで構成されています。プロパティを定義するフィールド辞書、チェック済みと未チェック状態をレンダリングするアピアランスストリーム、そしてフォームが処理されるときに送信されるデータを決定するエクスポート値です。フィールド辞書には、フィールド名(Tエントリ)、フィールドタイプ(FTは「Btn」に設定)、プッシュボタンやラジオボタンではないことを指定するフィールドフラグなどの属性が含まれます。アピアランス辞書(AP)には、通常、少なくとも2つのアピアランスストリームが含まれます。1つは「Off」状態用、もう1つはチェック済み状態用(多くの場合「Yes」またはカスタムエクスポート値)です。ユーザーがチェックボックスをクリックすると、PDFビューアはフィールドの値(Vエントリ)を対応する状態に一致するように更新し、適切なアピアランスを表示します。開発者は、PDF操作ライブラリを通じてこれらの値にアクセスし、変更することができます。現在の状態はVエントリを調べることで読み取り、新しい状態は対応するアピアランス状態(ASエントリ)とともにこの値を更新することで設定できます。
- Button Field(ボタンフィールド) – チェックボックス、ラジオボタン、プッシュボタンを包含する親フィールドタイプ
- Radio Button(ラジオボタン) – グループ内で相互に排他的な選択を行うためのボタンフィールドのサブタイプ
- Form Field(フォームフィールド) – ユーザー入力を収集するPDF内のあらゆるインタラクティブ要素
- Appearance Stream(アピアランスストリーム) – 異なる状態でフォームフィールドがどのように表示されるかを定義するグラフィカル表現
- Widget Annotation(ウィジェット注釈) – PDFページ上のフォームフィールドの視覚的表現とインタラクション領域
- (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
- (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
