GetXFAFormFieldValueA

Formulářová pole

Popis

Koncové A označuje vstupní bod DLL pro ANSI (char); povrch ActiveX/COM vystavuje jen Unicode formu. Chování je shodné s GetXFAFormFieldValue a řetězcové argumenty se interpretují podle aktuální kódové stránky SetAnsiMode

Vrací hodnotu zadaného pole formuláře XFA. Název pole může být relativní datová cesta nebo standardní datová SOM cesta začínající $data, xfa.datasets.data nebo $record. V paketech bez zpracování záznamů se $record rozliší z vnějšího elementu datového záznamu pod $data. Selektory DOM tříd dat #dataGroup a #dataValue vyberou seskupené či skalární datové uzly podle třídy s numerickými nebo zástupnými selektory výskytu. Jednoduché predikátové selektory ve stylu FormCalc, například $data.Receipt.Detail.[Total_Price > 200].Description, vyberou odpovídající sourozenecké datové uzly podle hodnoty dítěte. Úplné pakety XDP se přijímají, obsahuje-li paket datasets buď xfa:data, nebo datový element bez prefixu. Datové uzly se párují podle lokálního XML názvu, takže byznys datové elementy mohou používat vlastní namespace prefix. API hodnot datasets přijímají také SOM vlastnost parent, která vyleze z vybraného datového uzlu na jeho kontejner dřív, než se přečte sourozenec, například $data.Receipt.Detail[1].parent.Tax. Sestupné selektory jako $data..Total_Price rozliší první odpovídající datový uzel pod aktuálním rozsahem datasets. Zástupné selektory dítěte jako $data.Receipt.*.Total_Price vrátí odpovídající datové uzly pod každou přímou dětskou větví

Syntaxe

Delphi

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

DLL

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

Parametry

XFAFieldNameNázev datového pole XFA datasets, s nímž se má pracovat; přijímá relativní cesty polí, SOM kořeny $data..., xfa.datasets.data..., !data... a $record..., s tečkovými či lomítkovými oddělovači před nebo za kořenem; cesty s lomítky zachovávají doslovné tečky, SOM cesty s tečkami přijímají escapované tečky jako Line\.Item, opakované datové uzly lze vybrat cestami [*] jako $data.Receipt.Detail[*].Total_Price, parent vyleze na rodiče vybraného uzlu dřív, než cesta pokračuje, selektory tříd jako #dataGroup a #dataValue adresují skupiny a skalární hodnoty Data DOM, jednoduché predikátové selektory jako .[Total_Price > 200] filtrují sourozenecké datové uzly podle hodnoty dítěte, sestupné selektory jako $data..Total_Price hledají pod aktuálním rozsahem datasets a zástupné selektory dítěte jako $data.Receipt.*.Total_Price hledají pod každou přímou dětskou větví