SetXFAFormFieldValueA

Pola formularzy

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w SetXFAFormFieldValue, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Ustawia wartość wskazanego pola formularza XFA. Nazwa pola może być względną ścieżką danych albo standardową ścieżką SOM danych rozpoczynającą się od $data, xfa.datasets.data lub $record. W pakietach bez przetwarzania rekordów $record aktualizuje ścieżki od zewnętrznego elementu rekordu danych poniżej $data. Selektory klas Data DOM #dataGroup i #dataValue aktualizują grupowe lub skalarne węzły danych według klasy, z numerycznymi lub wieloznacznymi selektorami wystąpień. Proste selektory predykatów w stylu FormCalc, na przykład $data.Receipt.Detail.[Total_Price <= 200].Description, aktualizują pasujące węzły danych tego samego poziomu według wartości skalarnej potomka. Pełne pakiety XDP są akceptowane, gdy pakiet datasets zawiera element xfa:data albo element data bez prefiksu. Węzły danych są dopasowywane według lokalnej nazwy XML, dlatego elementy danych biznesowych mogą używać własnego prefiksu przestrzeni nazw. Interfejsy API wartości datasets przyjmują także właściwość SOM parent, aby przejść z wybranego węzła danych do jego kontenera przed zaktualizowaniem węzła tego samego poziomu, na przykład $data.Receipt.Detail[0].parent.Tax. Selektory potomków, takie jak $data..Total_Price, aktualizują pierwszy pasujący węzeł danych poniżej bieżącego zakresu datasets. Selektory wieloznaczne potomków, takie jak $data.Receipt.*.Total_Price, aktualizują pasujące węzły danych poniżej każdej bezpośredniej gałęzi potomnej

Składnia

Delphi

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

DLL

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

Parametry

XFAFieldName Nazwa pola datasets XFA, na którym wykonywana jest operacja; przyjmuje względne ścieżki pól oraz korzenie SOM $data..., xfa.datasets.data..., !data... i $record..., z ogranicznikami kropkowymi lub ukośnikowymi przed albo za korzeniem; ścieżki rozdzielone ukośnikami zachowują kropki dosłowne, ścieżki SOM rozdzielone kropkami przyjmują kropki poprzedzone znakiem ucieczki, na przykład Line\.Item, powtarzające się węzły danych można wybierać ścieżkami [*], takimi jak $data.Receipt.Detail[*].Total_Price, parent pozwala przejść do rodzica wybranego węzła przed kontynuacją ścieżki, selektory klas #dataGroup i #dataValue adresują grupy Data DOM i wartości skalarne, proste selektory predykatów, takie jak .[Total_Price <= 200], filtrują węzły danych tego samego poziomu według wartości skalarnej potomka, selektory potomków, takie jak $data..Total_Price, wyszukują poniżej bieżącego zakresu datasets, a selektory wieloznaczne potomków, takie jak $data.Receipt.*.Total_Price, wyszukują poniżej każdej bezpośredniej gałęzi potomnej

NewValue Nowa wartość pola XFA; gdy XFAFieldName zawiera [*], wieloznaczny selektor potomka albo selektor predykatu, ta sama wartość jest zapisywana do każdego pasującego węzła danych

XFAFieldName	Nazwa pola datasets XFA, na którym wykonywana jest operacja; przyjmuje względne ścieżki pól oraz korzenie SOM `$data...`, `xfa.datasets.data...`, `!data...` i `$record...`, z ogranicznikami kropkowymi lub ukośnikowymi przed albo za korzeniem; ścieżki rozdzielone ukośnikami zachowują kropki dosłowne, ścieżki SOM rozdzielone kropkami przyjmują kropki poprzedzone znakiem ucieczki, na przykład `Line\.Item`, powtarzające się węzły danych można wybierać ścieżkami `[]`, takimi jak `$data.Receipt.Detail[].Total_Price`, `parent` pozwala przejść do rodzica wybranego węzła przed kontynuacją ścieżki, selektory klas `#dataGroup` i `#dataValue` adresują grupy Data DOM i wartości skalarne, proste selektory predykatów, takie jak `.[Total_Price <= 200]`, filtrują węzły danych tego samego poziomu według wartości skalarnej potomka, selektory potomków, takie jak `$data..Total_Price`, wyszukują poniżej bieżącego zakresu datasets, a selektory wieloznaczne potomków, takie jak `$data.Receipt.*.Total_Price`, wyszukują poniżej każdej bezpośredniej gałęzi potomnej
NewValue	Nowa wartość pola XFA; gdy `XFAFieldName` zawiera `[*]`, wieloznaczny selektor potomka albo selektor predykatu, ta sama wartość jest zapisywana do każdego pasującego węzła danych