GetXFAFormFieldValueA

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 GetXFAFormFieldValue, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Zwraca wartość określonego pola formularza XFA. Nazwa pola może być względną ścieżką danych albo standardową ścieżką SOM danych zaczynającą się od $data, xfa.datasets.data lub $record. W pakietach nieprzetwarzających rekordów $record jest rozwiązywane od zewnętrznego elementu rekordu danych pod $data. Selektory klas Data DOM #dataGroup i #dataValue wybierają pogrupowane lub skalarne węzły danych według klasy, z liczbowymi selektorami wystąpienia lub symbolami wieloznacznymi. Proste selektory predykatów w stylu FormCalc, takie jak $data.Receipt.Detail.[Total_Price > 200].Description, wybierają zgodne równorzędne węzły danych według skalarnej wartości elementu podrzędnego. Pełne pakiety XDP są akceptowane, gdy pakiet datasets zawiera element xfa:data lub 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 akceptują również właściwość SOM parent, która przechodzi z wybranego węzła danych do jego kontenera przed odczytaniem elementu równorzędnego, na przykład $data.Receipt.Detail[1].parent.Tax. Selektory potomków, takie jak $data..Total_Price, rozwiązują pierwszy zgodny węzeł danych poniżej bieżącego zakresu datasets. Selektory symbolu wieloznacznego elementu podrzędnego, takie jak $data.Receipt.*.Total_Price, zwracają zgodne węzły danych pod każdą bezpośrednią gałęzią podrzędną

Składnia

Delphi

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

DLL

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

Parametry

XFAFieldNameNazwa pola datasets XFA, na którym ma zostać wykonana operacja; akceptuje względne ścieżki pól oraz korzenie SOM $data..., xfa.datasets.data..., !data... i $record..., z kropką lub ukośnikiem przed albo po korzeniu; ścieżki rozdzielane ukośnikami zachowują literalne kropki, ścieżki SOM rozdzielane kropkami akceptują kropki poprzedzone znakiem ucieczki, takie jak Line\.Item, powtarzające się węzły danych można wybierać za pomocą ścieżek [*], takich jak $data.Receipt.Detail[*].Total_Price, parent może przejść do elementu nadrzędnego wybranego węzła przed kontynuowaniem ścieżki, selektory klas, takie jak #dataGroup i #dataValue, adresują grupy Data DOM i wartości skalarne, proste selektory predykatów, takie jak .[Total_Price > 200], filtrują równorzędne węzły danych według skalarnej wartości elementu podrzędnego, selektory potomków, takie jak $data..Total_Price, przeszukują bieżący zakres datasets, a selektory symbolu wieloznacznego elementu podrzędnego, takie jak $data.Receipt.*.Total_Price, przeszukują każdą bezpośrednią gałąź podrzędną