GetXFAFormFieldValueA

Formularfelter

Beskrivelse

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

Returnerer værdien af det angivne XFA-formularfelt. Feltnavnet kan være en relativ datasti eller en standarddata-SOM-sti, der starter med $data, xfa.datasets.data eller $record. I pakker uden postbehandling opløses $record fra det ydre datapostelement under $data. Data DOM-klassevælgerne #dataGroup og #dataValue vælger grupperede eller skalære datanoder efter klasse med numeriske eller jokerbaserede forekomstvælgere. Enkle FormCalc-lignende prædikatvælgere såsom $data.Receipt.Detail.[Total_Price > 200].Description vælger matchende datanoder på samme niveau efter en underordnet skalærværdi. Komplette XDP-pakker accepteres, når datasets-pakken 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 namespacepræfiks. Værdi-API'erne for datasets accepterer også SOM-egenskaben parent for at gå fra en valgt datanode op til dens beholder, før en node på samme niveau læses, for eksempel $data.Receipt.Detail[1].parent.Tax. Efterkommervælgere såsom $data..Total_Price opløser den første matchende datanode under det aktuelle datasets-område. Underordnede jokertegnsvælgere såsom $data.Receipt.*.Total_Price returnerer matchende datanoder under hver direkte underordnet gren.

Syntaks

Delphi

Function DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

const char * DLGetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName);

Parametre

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

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