TXFAEventAction

Unit: HPDFXFAEventScript

Declaration

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

Adfærd

Repræsenterer en parset literal operation eller valideret mutation udsendt af den generelle event-host

Kind vælger presence, rå værdi, access eller en instance-operation; argumenter bærer indeks og instance-indstillinger

Den generelle host bruger Target som bindingsreference og VirtualPath som den validerede placering af en node, der oprettes under samme event

Action-værdier bruger UTF-8-tekst; ugyldig Unicode, action-felter eller budgetter afviser eventet inden dokumentpublicering

Brug TXFAWidgetRuntime.DispatchEvent til valideret replay og rollback i stedet for at anvende records direkte på et delt dokument

Identitetsbindinger og script-resultater bruger Value til deres validerede tekst og fortolkes af runtime'en snarere end som almindelige formularmutationer

Host-tilstandshandlinger bærer navn|værdi-tekst i Value; fokus-handlinger bærer focus eller clear, og reset-redigerings-handlinger har en tom Value med det valgte feltmål

PropertyPath adresserer en property under den formular-ejer, som Target vælger, med klasse-occurrences som font[0]/fill[0]/color[0]; den kan kombineres med VirtualPath, når ejeren blev indsat under det aktuelle event

En tom PropertyPath bevarer det eksisterende direkte bindingsmål; runtime'en validerer stidybde, skema-kardinalitet, choice-grupper og native node-budgetter, før oprettelse eller efterfølgende skrivninger anvendes

DataPath identificerer en frisk Data DOM-efterkommer oprettet af XML-import under den databinding, som Target vælger, med nul-baserede element-barn-positioner som 0/1; tekst, kommentarer og processing instructions tæller ikke som elementpositioner

DataPath kan ledsage VirtualPath, når den eede datagruppe blev oprettet af en form instance manager under det aktuelle event

xeakLoadDataXML bærer indkommende UTF-8 XML i Value, hvor Argument vælger ignoreRoot og Argument2 vælger overwrite; den native runtime parserer kilden, før det valgte mål ændres

Runtime'en opløser friske efterkommer-skrivninger og identitetspublicering mod den faktisk importerede native graf og anvender derefter samme event-transaktion og rollback som almindelige feltmutationer

Relaterede API'er

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