Form field flags

フォームフィールドフラグは、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ドキュメント内の各フォームフィールドタイプには、完全な動作プロファイルを定義するために、複数のフラグを同時に設定することができます。

フォームフィールドフラグは、個々のビットがPDFフォームフィールドの特定の動作属性を表す整数値です。外観や構造を定義するフォームフィールドプロパティとは異なり、フラグは特にユーザーインタラクションと検証ルールを制御します。各フラグは32ビット整数内の単一のビット位置に対応し、ビット演算を使用して複数のフラグを組み合わせることができます。一般的なフラグには、ReadOnly（ユーザーによる変更を防止）、Required（送信前に入力を必須化）、NoExport（フォーム送信からフィールドを除外）、Password（テキスト入力をマスク）、Multiline（複数行のテキストを許可）、MultiSelect（リストフィールドで複数選択を許可）などがあります。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 ) では、各フォームフィールドタイプに適用可能なフラグが定義されています。例えば、Pushbuttonフラグはボタンフィールドにのみ適用され、Comboフラグは選択フィールドにおいてコンボボックスとリストボックスを区別します。

フォームフィールドフラグは、データ検証、ユーザーエクスペリエンス、セキュリティを直接制御するため、インタラクティブなPDFフォームを実装する開発者にとって不可欠です。Requiredフラグを設定することで、フォーム送信前に重要な情報が収集されることを保証し、ReadOnlyフラグは計算済みまたは事前入力された値を変更から保護します。NoExportフラグを使用すると、送信されるフォームデータを煩雑にすることなく、計算や一時データのためにフィールドを使用できます。 ( 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フォーム開発の重要な側面となります。

フォームフィールドフラグは、フォームフィールドディクショナリのFf（フィールドフラグ）エントリに整数値として格納されます。開発者は、目的のフラグ値に対してビット単位のOR演算を実行してフラグを設定し、ビット単位のAND演算を使用して特定のフラグをチェックします。例えば、必須の読み取り専用テキストフィールドを作成するには、Requiredフラグ（ビット2）とReadOnlyフラグ（ビット1）の値を組み合わせます。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 ) では、各フラグの特定のビット位置が定義されています：ReadOnlyはビット1、Requiredはビット2、NoExportはビット13などです。PDFビューアまたはプロセッサがフォームフィールドに遭遇すると、Ff値を読み取り、対応する動作を適用します。一部のフラグは相互に排他的であるか、特定のフィールドタイプに対してのみ意味を持ちます。例えば、RadioフラグとPushbuttonフラグは、ボタンフィールドのサブタイプを区別します。DoNotSpellCheckフラグとNoToggleToOffフラグはフィールド動作の追加的な調整を提供し、Sortフラグは定義された順序ではなくソート順で選択肢を表示するようビューアに指示します。

• Form field – ユーザー入力または選択を受け付けるPDF内のインタラクティブな要素
• Interactive form – データ収集とユーザーインタラクションを可能にするPDFドキュメント内のフォームフィールドのコレクション
• Field dictionary – フォームフィールドのプロパティ、外観、動作を定義するPDFオブジェクト構造
• AcroForm – フォームフィールドディクショナリを使用してインタラクティブフォームを作成する従来のPDF技術
• Widget annotation – PDFページ上のフォームフィールドの視覚的表現