Current value (V)

現在値（V）は、インタラクティブフォームフィールドのフィールド辞書内に必須のエントリとして存在し、フィールドの現在のデータ状態を格納します ( 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 ) 。この値は、ユーザーがフォームフィールドに入力または選択した内容を表し、フィールドの初期状態を表すデフォルト値（DV）とは区別されます。Vエントリは、ユーザーがPDFフォームを完成させた際に送信される実際の情報を含むため、フォームデータ処理の基本となります。

現在値は、PDF構造内のフォームフィールドの辞書にVエントリとして格納されます。Vエントリのデータ型と形式は、フィールドタイプによって異なります。テキストフィールドは文字列を格納し、チェックボックスは名前値（通常は/Yesまたは/Off）を格納し、ラジオボタンは選択されたオプションの名前を格納し、チョイスフィールドは選択された項目を格納し、ボタンフィールドは様々なアクション関連データを格納する場合があります。フィールドの元の状態またはリセット状態を表すデフォルト値（DV）とは異なり、Vエントリはユーザーがフォームを操作するにつれて動的に変化します。PDFフォームが開かれると、フィールドは存在する場合はVエントリを表示し、現在値が設定されていない場合はDVエントリにフォールバックします。PDF仕様によれば、Vエントリはほとんどのフォームフィールドタイプで必須とされており ( 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フォームを扱う開発者にとって、現在値を理解することは、いくつかの実用的な理由から不可欠です。フォーム入力アプリケーションを実装する際、セッションやプラットフォーム間でユーザー入力を保持するために、Vエントリを正しく読み書きする必要があります。フォーム送信ワークフローは、すべてのフィールドからVエントリを抽出してバックエンドシステムやデータベースにデータを送信することに依存しています。データ検証ルーチンは、処理前にユーザーが完全かつ正しい形式の情報を提供したことを確認するために現在値を検査する必要があります。アクセシブルなPDFフォームを作成する際、視覚的な外観と基礎となるVエントリとの関係を維持し、スクリーンリーダーや支援技術が障害のあるユーザーにフィールドの内容を正確に伝えられるようにする必要があります。さらに、フォームフィールドのリセット機能では、Vエントリを対応するDV値に戻す方法を理解する必要があり、フォームの事前入力機能では、外部データソースに基づいてVエントリをプログラム的に設定する必要があります。

技術的には、Vエントリは、PDFドキュメント構造内の各インタラクティブフォームフィールドオブジェクトのフィールド辞書内に存在します。PDFビューアがフォームフィールドをレンダリングする際、フィールド辞書からVエントリを照会し、フィールドの外観設定とウィジェット注釈に従ってその内容を表示します。ユーザーがフィールドを操作すると、PDFプロセッサはメモリ内のVエントリを更新し、保存時に変更された値をPDFファイル構造に書き戻します。テキストフィールドの場合、Vエントリには改行や特殊文字を含むテキスト文字列が含まれ、PDF文字列規則に従ってエンコードされます。チェックボックスとラジオボタンの場合、Vエントリは選択状態を示す名前オブジェクト（/Yes、/Off、またはカスタムエクスポート値など）を保持します。リストボックスやコンボボックスなどのチョイスフィールドは、複数選択が有効かどうかに応じて、Vエントリに単一の文字列または文字列の配列を格納します。Vエントリとフィールドの外観ストリームとの関係により、ユーザーが見るものと基礎となるデータ値が一致することが保証されます。フィールド継承により、子フィールドは明示的にオーバーライドされない限り親フィールドからVエントリを継承できます。これは、複数の子ウィジェットがグループの現在値を含む共通の親フィールド辞書を共有するラジオボタングループに特に関連します。

• デフォルト値（DV） – フォームフィールドの初期値またはリセット値で、現在値とは別に格納されます
• フィールド辞書 – インタラクティブフォームフィールドのすべてのプロパティとデータを含むPDF辞書オブジェクト
• ウィジェット注釈 – ユーザーに現在値を表示するフォームフィールドの視覚的表現
• 外観ストリーム – フォームフィールドとその値が視覚的にどのようにレンダリングされるかを定義するPDFコンテンツストリーム
• エクスポート値 – フォームが送信される際に送信されるデータ値で、表示される値とは異なる場合があります