SetXFAFormFieldValueA
フォームフィールド
説明
末尾の A は ANSI(char)DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は SetXFAFormFieldValue と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます
指定された XFA フォームフィールドの値を設定します。フィールド名は相対データパス、または $data、xfa.datasets.data、$record で始まる標準データ SOM パスにできます。レコード処理以外のパケットでは、$record は $data の下にある外側のデータレコード要素からパスを更新します。Data DOM クラスセレクター #dataGroup および #dataValue は、数値またはワイルドカードの出現セレクターを使用して、クラス別にグループ化データノードまたはスカラーデータノードを更新します。$data.Receipt.Detail.[Total_Price <= 200].Description などの単純な FormCalc 形式の述語セレクターは、子スカラー値によって一致する兄弟データノードを更新します。datasets パケットに xfa:data またはプレフィックスなしの data 要素のいずれかが含まれる場合、完全な XDP パケットを受け入れます。データノードはローカル XML 名で照合されるため、業務データ要素には独自の名前空間プレフィックスを使用できます。datasets 値 API では、選択したデータノードからコンテナへ上がって兄弟を更新するための SOM の parent プロパティも受け入れます。例: $data.Receipt.Detail[0].parent.Tax。$data..Total_Price などの子孫セレクターは、現在の datasets スコープの下で最初に一致するデータノードを更新します。$data.Receipt.*.Total_Price などの子ワイルドカードセレクターは、各直接子ブランチの下で一致するデータノードを更新します
構文
Delphi
Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;
DLL
int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);
パラメータ
| XFAFieldName | 処理対象の XFA datasets フィールド名。相対フィールドパス、$data...、xfa.datasets.data...、!data...、$record... SOM ルートを受け入れ、ルートの前後にはドットまたはスラッシュ区切りを使用できます。スラッシュ区切りパスはリテラルのピリオドを保持し、ドット区切り SOM パスは Line\.Item のようなエスケープ済みピリオドを受け入れます。繰り返されるデータノードは [*] パス、たとえば $data.Receipt.Detail[*].Total_Price で選択できます。parent はパスを続ける前に選択ノードの親へ移動できます。#dataGroup や #dataValue などのクラスセレクターは Data DOM グループとスカラー値を参照します。.[Total_Price <= 200] のような単純述語セレクターは子スカラー値で兄弟データノードを絞り込みます。$data..Total_Price のような子孫セレクターは現在の datasets スコープ以下を検索し、$data.Receipt.*.Total_Price のような子ワイルドカードセレクターは直接の各子分岐以下を検索します |
|---|---|
| NewValue | XFA フィールドの新しい値です。XFAFieldName に [*]、子ワイルドカードセレクターまたは述語セレクターが含まれる場合、同じ値が一致するすべてのデータノードに書き込まれます |