SetXFAFormFieldValueA

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 SetXFAFormFieldValue a řetězcové argumenty se interpretují podle aktuální kódové stránky SetAnsiMode

Nastaví 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ů $record aktualizuje cesty z vnějšího elementu datového záznamu pod $data. Selektory DOM tříd dat #dataGroup a #dataValue aktualizují 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, aktualizují 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 aktualizuje sourozenec, například $data.Receipt.Detail[0].parent.Tax. Sestupné selektory jako $data..Total_Price aktualizují první odpovídající datový uzel pod aktuálním rozsahem datasets. Zástupné selektory dítěte jako $data.Receipt.*.Total_Price aktualizují odpovídající datové uzly pod každou přímou dětskou větví

Syntaxe

Delphi

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

DLL

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

Parametry

XFAFieldName	Ná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í
NewValue	Nová hodnota pole XFA; obsahuje-li XFAFieldName [*], zástupný selektor dítěte nebo predikátový selektor, zapíše se stejná hodnota do každého odpovídajícího datového uzlu

XFAFieldName

Ná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í

NewValue

Nová hodnota pole XFA; obsahuje-li XFAFieldName [*], zástupný selektor dítěte nebo predikátový selektor, zapíše se stejná hodnota do každého odpovídajícího datového uzlu