TXFAEventAction

Unit: HPDFXFAEventScript

Deklarace

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

Chování

Reprezentuje parsovanou literální operaci či validovanou mutaci emitovanou obecným hostitelem událostí

Kind vybírá presence, raw value, access či operaci výskytu; argumenty nesou indexy a nastavení výskytů

Obecný hostitel používá Target jako binding referenci a VirtualPath jako validované umístění uzlu vytvořeného během téže události

Hodnoty akcí používají UTF-8 text; neplatný Unicode, akční pole či rozpočty odmítnou událost dřív než publikaci dokumentu

Pro validovaný replay a rollback použijte TXFAWidgetRuntime.DispatchEvent, místo abyste záznamy aplikovali přímo na sdílený dokument

Vazby identity i skriptové výsledky používají Value pro svůj validovaný text a interpretuje je runtime, nikoli jako běžné formulářové mutace

Akce stavu hostitele nesou text name|value ve Value; akce fokusu nesou focus či clear a akce resetu editace mají prázdné Value s vybraným cílovým polem

PropertyPath adresuje vlastnost pod form vlastníkem vybraným přes Target, s využitím výskytů tříd jako font[0]/fill[0]/color[0]; dá se kombinovat s VirtualPath, když byl vlastník vložený během aktuální události

Prázdný PropertyPath zachovává stávající přímý binding cíl; runtime validuje hloubku cesty, kardinalitu schématu, choice skupiny i nativní rozpočty uzlů, dřív než aplikuje tvorbu či následné zápisy

DataPath identifikuje čerstvého potomka Data DOM vytvořeného XML importem pod datovým bindingem vybraným přes Target, s využitím zero-based pozic elementových potomků jako 0/1; text, komentáře a processing instructions se jako pozice elementů nepočítají

DataPath může doprovázet VirtualPath, když vlastnící datovou skupinu vytvořil form instance manager během aktuální události

xeakLoadDataXML nese příchozí UTF-8 XML ve Value, přičemž Argument volí ignoreRoot a Argument2 overwrite; nativní runtime parseuje zdroj dřív, než změní vybraný cíl

Runtime rozřeší čerstvé zápisy potomkům i publikaci identity vůči skutečnému importovanému nativnímu grafu a pak aplikuje tutéž transakci události i rollback jako u běžných mutací polí

Související API

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