SetXFAFormFieldValue

Formulářová pole

Popis

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 TPDFlib.SetXFAFormFieldValue(Const XFAFieldName, NewValue: WideString): Integer;

ActiveX

Function PDFlib::SetXFAFormFieldValue(XFAFieldName As String, NewValue As String) As Long

DLL

int DLSetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName, const wchar_t * 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