SetXFAFormFieldValueA

Campi modulo

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a SetXFAFormFieldValue e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta il valore del campo modulo XFA specificato. Il nome del campo può essere un percorso relativo dei dati o un percorso SOM standard dei dati che inizia con $data, xfa.datasets.data o $record. Nei pacchetti che non elaborano record, $record aggiorna i percorsi a partire dall'elemento record di dati esterno sotto $data. I selettori di classe Data DOM #dataGroup e #dataValue aggiornano per classe i nodi di dati raggruppati o scalari, con selettori numerici o jolly delle occorrenze. I selettori di predicato semplici in stile FormCalc, come $data.Receipt.Detail.[Total_Price <= 200].Description, aggiornano i nodi di dati adiacenti corrispondenti in base al valore scalare figlio. Sono accettati pacchetti XDP completi quando il pacchetto dei set di dati contiene un elemento xfa:data o data senza prefisso. I nodi di dati vengono confrontati in base al nome XML locale, quindi gli elementi dei dati aziendali possono usare un proprio prefisso dello spazio dei nomi. Le API dei valori dei set di dati accettano inoltre la proprietà SOM parent per risalire da un nodo di dati selezionato al relativo contenitore prima di aggiornare un elemento adiacente, ad esempio $data.Receipt.Detail[0].parent.Tax. I selettori di discendenti come $data..Total_Price aggiornano il primo nodo di dati corrispondente sotto l'ambito corrente dei set di dati. I selettori jolly dei figli come $data.Receipt.*.Total_Price aggiornano i nodi di dati corrispondenti sotto ogni ramo figlio diretto

Sintassi

Delphi

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

DLL

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

Parametri

XFAFieldName Nome del campo datasets XFA su cui operare; accetta percorsi relativi, radici SOM $data..., xfa.datasets.data..., !data... e $record..., con delimitatori punto o barra prima o dopo la radice; i percorsi delimitati da barre preservano i punti letterali, quelli SOM delimitati da punti accettano punti sottoposti a escape come Line\.Item, i nodi dati ripetuti possono essere selezionati con percorsi [*] quali $data.Receipt.Detail[*].Total_Price, parent può risalire al padre del nodo selezionato prima di proseguire, selettori di classe quali #dataGroup e #dataValue indirizzano gruppi e valori scalari Data DOM, selettori predicato semplici quali .[Total_Price <= 200] filtrano i nodi dati fratelli in base al valore scalare figlio, selettori discendenti quali $data..Total_Price cercano sotto l'ambito datasets corrente e selettori jolly figli quali $data.Receipt.*.Total_Price cercano sotto ogni ramo figlio diretto

NewValue Nuovo valore per il campo XFA; quando XFAFieldName contiene [*], un selettore jolly dei figli o un selettore di predicato, lo stesso valore viene scritto in ogni nodo di dati corrispondente

XFAFieldName	Nome del campo datasets XFA su cui operare; accetta percorsi relativi, radici SOM `$data...`, `xfa.datasets.data...`, `!data...` e `$record...`, con delimitatori punto o barra prima o dopo la radice; i percorsi delimitati da barre preservano i punti letterali, quelli SOM delimitati da punti accettano punti sottoposti a escape come `Line\.Item`, i nodi dati ripetuti possono essere selezionati con percorsi `[]` quali `$data.Receipt.Detail[].Total_Price`, `parent` può risalire al padre del nodo selezionato prima di proseguire, selettori di classe quali `#dataGroup` e `#dataValue` indirizzano gruppi e valori scalari Data DOM, selettori predicato semplici quali `.[Total_Price <= 200]` filtrano i nodi dati fratelli in base al valore scalare figlio, selettori discendenti quali `$data..Total_Price` cercano sotto l'ambito datasets corrente e selettori jolly figli quali `$data.Receipt.*.Total_Price` cercano sotto ogni ramo figlio diretto
NewValue	Nuovo valore per il campo XFA; quando `XFAFieldName` contiene `[*]`, un selettore jolly dei figli o un selettore di predicato, lo stesso valore viene scritto in ogni nodo di dati corrispondente