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フォームフィールドのディクショナリ内の/Ffキーの下に整数値として格納される一連のバイナリフラグです。この整数の各ビット位置は、フィールドの特定の動作またはプロパティに対応しています。例えば、ビット1（値2）はフィールドが読み取り専用かどうかを制御し、ビット13（値4096）はテキストフィールドが複数行を許可するかどうかを決定します。 ( 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 ) で指定されているように、異なるフィールドタイプ（テキストフィールド、ボタン、選択フィールド）は、異なるフラグのサブセットをサポートします。

別々のディクショナリエントリを使用するフィールドプロパティとは異なり、フィールドフラグはコンパクトなビットマスク表現を使用し、複数の動作が単一の整数にエンコードされます。このアプローチにより、効率的なストレージと、フィールドの動作をチェックまたは変更するための高速なビット単位の操作が可能になります。フラグは累積的です。複数のフラグを設定するには、対応するビット値の合計を計算する（またはビット単位のOR演算を使用する）必要があります。

フィールドフラグは、ユーザーエクスペリエンスとデータの整合性を直接制御するため、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 ) などの標準に準拠したアクセシビリティのためには、適切なフィールドフラグの構成により、支援技術がフィールドの動作を正しく解釈できるようになります。

不適切なフィールドフラグの構成は、編集可能であるべきフィールドにユーザーがデータを入力できない、または複数行のテキストフィールドが予期せず改行を拒否するなどの使いやすさの問題につながる可能性があります。フィールドフラグを理解することで、開発者はデータ検証、ワークフロー制御、規制遵守のビジネス要件に合致するフォームを作成できます。

フィールドフラグは、フィールドのディクショナリに格納された整数値に対するビット単位の演算を通じて動作します。複数のフラグを設定するには、開発者は各希望するフラグの10進数値を加算するか、ビット単位のOR演算を使用します。例えば、テキストフィールドを読み取り専用（ビット1、値2）かつ必須（ビット2、値4）の両方にするには、フィールドフラグを6（2 + 4）に設定します。

一般的なフィールドフラグには以下が含まれます：

• Read-only（ビット1、値1）：ユーザーによる変更を防止
• Required（ビット2、値2）：送信時にフィールドに値が必要
• NoExport（ビット3、値4）：フォーム送信からフィールド値を除外
• Multiline（ビット13、値4096）：テキストフィールドが複数行を受け入れる
• Password（ビット14、値8192）：テキストフィールドがマスクされた文字を表示
• NoToggleToOff（ビット15、値16384）：ラジオボタンの選択を解除できない
• Radio（ビット16、値32768）：グループ内の個別のラジオボタン

PDFプロセッサがフォームフィールドをレンダリングする際、フィールドフラグ値を読み取り、対応する動作を適用します。インタラクティブなPDFライブラリは、ビット単位のAND、OR、NOT演算を使用して個別のフラグを読み取り、設定、クリアするメソッドを提供し、開発者がフラグ値を手動で計算することなく、プログラムでフィールドの動作を変更できるようにします。

• Form fields（フォームフィールド） – ユーザー入力を収集するPDFドキュメント内のインタラクティブな要素
• Appearance streams（アピアランスストリーム） – フォームフィールドのレンダリング方法の視覚的表現
• Acroform – フィールドディクショナリとアノテーションを使用したPDFの従来のフォーム技術
• Field dictionary（フィールドディクショナリ） – フォームフィールドのすべてのプロパティと構成を含むPDFオブジェクト
• Widget annotations（ウィジェットアノテーション） – PDFページ上にフォームフィールドを表示する視覚的コンポーネント