GetXFAFormFieldValueA

Champs de formulaire

Description

Le A final indique le point d’entrée de DLL ANSI (char); l’interface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à GetXFAFormFieldValue et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Renvoie la valeur du champ XFA indiqué. Son nom peut être un chemin relatif ou un chemin SOM commençant par $data, xfa.datasets.data ou $record. Hors paquets de traitement d’enregistrements, $record part de l’élément d’enregistrement externe sous $data. Les sélecteurs #dataGroup et #dataValue ciblent les nœuds groupés ou scalaires avec occurrences numériques ou jokers. Les prédicats comme $data.Receipt.Detail.[Total_Price > 200].Description sélectionnent les frères selon une valeur enfant. Les paquets XDP complets sont acceptés si datasets contient xfa:data ou un élément data sans préfixe. La correspondance utilise le nom XML local. La propriété SOM parent remonte au conteneur avant de lire un frère, par exemple $data.Receipt.Detail[1].parent.Tax. Les descendants comme $data..Total_Price renvoient le premier nœud sous la portée courante. Les jokers enfants comme $data.Receipt.*.Total_Price renvoient les correspondances sous chaque branche directe

Syntaxe

Delphi

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

DLL

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

Paramètres

XFAFieldName Nom du champ XFA datasets à traiter ; accepte les chemins relatifs et les racines SOM $data..., xfa.datasets.data..., !data... et $record..., avec séparateurs point ou barre oblique autour de la racine ; les chemins à barres conservent les points littéraux, ceux à points acceptent les points échappés comme Line\.Item, les nœuds répétés se sélectionnent avec [*], par exemple $data.Receipt.Detail[*].Total_Price, parent remonte au parent, les sélecteurs de classe #dataGroup et #dataValue ciblent groupes et valeurs scalaires, les prédicats simples comme .[Total_Price > 200] filtrent les frères, les sélecteurs descendants comme $data..Total_Price cherchent sous la portée courante et les jokers enfants comme $data.Receipt.*.Total_Price cherchent sous chaque branche enfant directe

XFAFieldName	Nom du champ XFA datasets à traiter ; accepte les chemins relatifs et les racines SOM `$data...`, `xfa.datasets.data...`, `!data...` et `$record...`, avec séparateurs point ou barre oblique autour de la racine ; les chemins à barres conservent les points littéraux, ceux à points acceptent les points échappés comme `Line\.Item`, les nœuds répétés se sélectionnent avec `[]`, par exemple `$data.Receipt.Detail[].Total_Price`, `parent` remonte au parent, les sélecteurs de classe `#dataGroup` et `#dataValue` ciblent groupes et valeurs scalaires, les prédicats simples comme `.[Total_Price > 200]` filtrent les frères, les sélecteurs descendants comme `$data..Total_Price` cherchent sous la portée courante et les jokers enfants comme `$data.Receipt.*.Total_Price` cherchent sous chaque branche enfant directe