TXFAEventAction

Unit: HPDFXFAEventScript

Declaration

TXFAEventAction= record
  Kind: TXFAEventActionKind;
  Target, Presence, Value: AnsiString;
  Argument, Argument2: Integer;
  VirtualPath: AnsiString;
  PropertyPath: AnsiString;
  DataPath: AnsiString;
end;

Behavior

Reprezentuje sparsowaną operację literalną albo walidowaną mutację emitowaną przez ogólnego hosta zdarzeń

Kind wybiera presence, surową wartość, dostęp albo operację instancji; argumenty niosą indeksy i ustawienia instancji

Ogólny host używa Target jako referencji powiązania, a VirtualPath jako walidowanej lokalizacji węzła utworzonego w tym samym zdarzeniu

Wartości akcji używają tekstu UTF-8; niepoprawny Unicode, pola akcji albo limity odrzucają zdarzenie przed publikacją dokumentu

Używaj TXFAWidgetRuntime.DispatchEvent dla walidowanego replay i rollbacku zamiast stosować rekordy bezpośrednio do współdzielonego dokumentu

Powiązania tożsamości i wyniki skryptów używają Value dla walidowanego tekstu i są interpretowane przez runtime, a nie jako zwykłe mutacje formularza

Akcje stanu hosta niosą tekst name|value w Value; akcje fokusu niosą focus albo clear, a akcje resetu edycji mają pustą Value z wybranym celem pola

PropertyPath adresuje właściwość pod właścicielem formularza wybranym przez Target, używając wystąpień klas, takich jak font[0]/fill[0]/color[0]; można go łączyć z VirtualPath, gdy właściciel był wstawiany podczas bieżącego zdarzenia

Pusty PropertyPath zachowuje istniejący bezpośredni cel powiązania; runtime waliduje głębokość ścieżki, krotność schematu, grupy choice i natywne budżety węzłów przed zastosowaniem tworzenia i kolejnych zapisów

DataPath identyfikuje świeżego potomka Data DOM utworzonego przez import XML pod powiązaniem danych wybranym przez Target, używając pozycji potomków-elementów opartych na zerze, takich jak 0/1; tekst, komentarze i instrukcje przetwarzania nie liczą się jako pozycje elementów

DataPath może towarzyszyć VirtualPath, gdy posiadająca grupa danych została utworzona przez menedżera instancji formularza w bieżącym zdarzeniu

xeakLoadDataXML niesie przychodzący XML UTF-8 w Value, z Argument wybierającym ignoreRoot i Argument2 wybierającym overwrite; natywny runtime parsuje źródło przed zmianą wybranego celu

Runtime rozpoznaje świeże zapisy potomków i publikację tożsamości względem rzeczywiście zaimportowanego natywnego grafu, a potem stosuje tę samą transakcję i rollback zdarzenia co zwykłe mutacje pól

Related APIs

Interactive Dynamic XFA Widget Runtime, FormCalc Functions i XFA Packet DOM