SetXFAFormFieldValueA
Formuliervelden
Beschrijving
De afsluitende A geeft het ANSI (char)-DLL-entrypoint aan; het ActiveX/COM-oppervlak biedt alleen de Unicode-vorm. Het gedrag is identiek aan SetXFAFormFieldValue en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina
Zet de waarde van het opgegeven XFA-formulierveld. De veldnaam kan een relatief datapad zijn of een standaard data-SOM-pad dat begint met $data, xfa.datasets.data of $record. In pakketten zonder recordverwerking werken $record-paden vanuit het buitenste datarecord-element onder $data. Data DOM-klasseselectors #dataGroup en #dataValue werken gegroepeerde of scalaire datanodes bij op klasse, met numerieke of wildcard-voorkomstselectors. Eenvoudige FormCalc-stijl-predicaatselectors zoals $data.Receipt.Detail.[Total_Price <= 200].Description werken matchende sibling-datanodes bij op de scalaire waarde van een child. Volledige XDP-pakketten worden geaccepteerd wanneer het datasets-pakket xfa:data of een prefix-loos data-element bevat. Datanodes worden gematcht op lokale XML-naam, dus bedrijfsdata-elementen mogen hun eigen namespace-prefix gebruiken. De datasets-waarde-API's accepteren ook de SOM parent-eigenschap om van een geselecteerde datanode naar zijn container te klimmen voordat een sibling wordt bijgewerkt, bijvoorbeeld $data.Receipt.Detail[0].parent.Tax. Afstammingsselectors zoals $data..Total_Price werken de eerste matchende datanode onder de huidige datasets-scope bij. Child-wildcardselectors zoals $data.Receipt.*.Total_Price werken matchende datanodes onder elke directe child-tak bij
Syntaxis
Delphi
Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;
DLL
int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);
Parameters
| XFAFieldName | De te bewerken XFA datasets-veldnaam; accepteert relatieve veldpaden, $data...-, xfa.datasets.data...-, !data...- en $record...-SOM-wortels, met punt- of slashscheiding vóór of ná de wortel; slash-gescheiden paden behouden letterlijke punten, op punten gescheiden SOM-paden accepteren geëscapeerde punten zoals Line\.Item, herhaalde datanodes kunnen worden geselecteerd met [*]-paden zoals $data.Receipt.Detail[*].Total_Price, parent kan klimmen naar de parent van de geselecteerde node voordat het pad verdergaat, klasseselectors zoals #dataGroup en #dataValue adresseren Data DOM-groepen en scalaire waarden, eenvoudige predicaatselectors zoals .[Total_Price <= 200] filteren sibling-datanodes op de scalaire waarde van een child, afstammingsselectors zoals $data..Total_Price zoeken onder de huidige datasets-scope, en child-wildcardselectors zoals $data.Receipt.*.Total_Price zoeken onder elke directe child-tak |
|---|---|
| NewValue | De nieuwe waarde voor het XFA-veld; bevat XFAFieldName [*], een child-wildcardselector of een predicaatselector, dan wordt dezelfde waarde naar elke matchende datanode geschreven |