SetXFAFormFieldValue

Champs de formulaire

Description

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 TPDFlib.SetXFAFormFieldValue(Const XFAFieldName, NewValue: WideString): Integer;

ActiveX

Function PDFlib::SetXFAFormFieldValue(XFAFieldName As String, NewValue As String) As Long

DLL

int DLSetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName, const wchar_t * 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