SetXFAFormFieldValueA

Formularfelter

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med SetXFAFormFieldValue, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Indstiller værdien af det angivne XFA-formularfelt. Feltnavnet kan være en relativ datasti eller en standard-SOM-datasti, der starter med $data, xfa.datasets.data eller $record. I pakker uden postbehandling opdaterer $record stier fra det ydre dataregistrelement under $data. Data DOM-klassevælgerne #dataGroup og #dataValue opdaterer grupperede eller skalare datanoder efter klasse med numeriske eller jokertegnsbaserede forekomstvælgere. Enkle prædikatvælgere i FormCalc-stil såsom $data.Receipt.Detail.[Total_Price <= 200].Description opdaterer matchende sidestillede datanoder efter en underordnet skalarværdi. Komplette XDP-pakker accepteres, når datasætpakken indeholder enten et xfa:data-element eller et data-element uden præfiks. Datanoder matches efter lokalt XML-navn, så forretningsdataelementer kan bruge deres eget namespace-præfiks. API'erne for datasætværdier accepterer også SOM-egenskaben parent for at gå fra en valgt datanode op til dens container, før en sidestillet node opdateres, for eksempel $data.Receipt.Detail[0].parent.Tax. Efterkommervælgere såsom $data..Total_Price opdaterer den første matchende datanode under det aktuelle datasætområde. Jokertegnsvælgere for underordnede elementer såsom $data.Receipt.*.Total_Price opdaterer matchende datanoder under hver direkte underordnet gren

Syntaks

Delphi

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

DLL

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

Parametre

XFAFieldName Navnet på det XFA-datasetsfelt, der skal arbejdes med; accepterer relative feltstier, SOM-rødderne $data..., xfa.datasets.data..., !data... og $record... med punktum eller skråstreg før eller efter roden; stier afgrænset med skråstreger bevarer bogstavelige punktummer, SOM-stier afgrænset med punktummer accepterer escaped punktummer som Line\.Item, gentagne datanoder kan vælges med [*]-stier som $data.Receipt.Detail[*].Total_Price, parent kan gå op til den valgte nodes overordnede element, før stien fortsættes, klassevælgere som #dataGroup og #dataValue adresserer Data DOM-grupper og skalarværdier, enkle prædikatvælgere som .[Total_Price <= 200] filtrerer underordnede datanoder efter en underordnet skalarværdi, efterkommervælgere som $data..Total_Price søger under det aktuelle datasetsområde, og wildcardvælgere for underordnede elementer som $data.Receipt.*.Total_Price søger under hver direkte underordnet gren

NewValue Den nye værdi for XFA-feltet; når XFAFieldName indeholder [*], en jokertegnsvælger for underordnede elementer eller en prædikatvælger, skrives den samme værdi til hver matchende datanode

XFAFieldName	Navnet på det XFA-datasetsfelt, der skal arbejdes med; accepterer relative feltstier, SOM-rødderne `$data...`, `xfa.datasets.data...`, `!data...` og `$record...` med punktum eller skråstreg før eller efter roden; stier afgrænset med skråstreger bevarer bogstavelige punktummer, SOM-stier afgrænset med punktummer accepterer escaped punktummer som `Line\.Item`, gentagne datanoder kan vælges med `[]`-stier som `$data.Receipt.Detail[].Total_Price`, `parent` kan gå op til den valgte nodes overordnede element, før stien fortsættes, klassevælgere som `#dataGroup` og `#dataValue` adresserer Data DOM-grupper og skalarværdier, enkle prædikatvælgere som `.[Total_Price <= 200]` filtrerer underordnede datanoder efter en underordnet skalarværdi, efterkommervælgere som `$data..Total_Price` søger under det aktuelle datasetsområde, og wildcardvælgere for underordnede elementer som `$data.Receipt.*.Total_Price` søger under hver direkte underordnet gren
NewValue	Den nye værdi for XFA-feltet; når `XFAFieldName` indeholder `[*]`, en jokertegnsvælger for underordnede elementer eller en prædikatvælger, skrives den samme værdi til hver matchende datanode