GetXFAFormFieldValueA

フォームフィールド

説明

末尾の A は ANSI(char)DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は GetXFAFormFieldValue と同じで、文字列引数は現在の 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[1].parent.Tax です。$data..Total_Price などの子孫セレクターは、現在の datasets スコープの下にある最初の一致データノードを解決します。$data.Receipt.*.Total_Price などの子ワイルドカードセレクターは、直接の各子分岐の下にある一致データノードを返します

構文

Delphi

Function DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

const char * DLGetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName);

パラメータ

XFAFieldName操作対象の XFA データセットフィールド名。相対フィールドパス、$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 のような子孫セレクターは現在のデータセットスコープより下を検索し、$data.Receipt.*.Total_Price のような子ワイルドカードセレクターは各直接子ブランチより下を検索します