SetXFAFormFieldValueA

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 à SetXFAFormFieldValue et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Définit 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 mettent à jour les nœuds groupés ou scalaires avec occurrences numériques ou jokers. Les prédicats comme $data.Receipt.Detail.[Total_Price <= 200].Description ciblent 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 mettre à jour un frère, par exemple $data.Receipt.Detail[0].parent.Tax. Les descendants comme $data..Total_Price mettent à jour le premier nœud sous la portée courante. Les jokers enfants comme $data.Receipt.*.Total_Price ciblent les correspondances sous chaque branche directe

Syntaxe

Delphi

Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;

DLL

int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);

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

NewValue Nouvelle valeur du champ XFA ; si XFAFieldName contient [*], un joker enfant ou un prédicat, la même valeur est écrite dans chaque nœud correspondant

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
NewValue	Nouvelle valeur du champ XFA ; si `XFAFieldName` contient `[*]`, un joker enfant ou un prédicat, la même valeur est écrite dans chaque nœud correspondant