TXFAEventAction

Unit: HPDFXFAEventScript

Declaration

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

Behavior

Representeert een geparsde letterlijke operatie of gevalideerde mutatie uitgeschreven door de algemene event-host

Kind kiest presence, raw value, access of een instance-operatie; argumenten dragen indices en instance-instellingen

De algemene host gebruikt Target als binding-referentie en VirtualPath als de gevalideerde locatie van een node die tijdens hetzelfde event wordt aangemaakt

Action-waarden gebruiken UTF-8-tekst; ongeldige Unicode, action-velden of budgetten verwerpen het event vóór documentpublicatie

Gebruik TXFAWidgetRuntime.DispatchEvent voor gevalideerde replay en rollback in plaats van records direct toe te passen op een gedeeld document

Identity-bindingen en script-resultaten gebruiken Value voor diens gevalideerde tekst en worden door de runtime geïnterpreteerd in plaats van als gewone formuliermutaties

Host-status-actions dragen name|value-tekst in Value; focus-actions dragen focus of clear, en reset-bewerkings-actions hebben een lege Value met de gekozen veldtarget

PropertyPath richt zich op een property onder de formulier-eigenaar die Target selecteert, met class-occurrences zoals font[0]/fill[0]/color[0]; hij kan worden gecombineerd met VirtualPath wanneer de eigenaar tijdens het huidige event werd ingevoegd

Een lege PropertyPath behoudt de bestaande directe binding-target; de runtime valideert pad-diepte, schema-cardinaliteit, choice-groepen en native node-budgetten vóór het toepassen van creatie of daaropvolgende writes

DataPath identificeert een verse Data DOM-afstammeling aangemaakt door XML-import onder de databinding die Target selecteert, met zero-based element-kind-posities zoals 0/1; tekst, comments en processing instructions tellen niet als elementposities

DataPath kan VirtualPath vergezellen wanneer de bezittende datagroep door een form instance manager tijdens het huidige event werd aangemaakt

xeakLoadDataXML draagt de inkomende UTF-8-XML in Value, met Argument die ignoreRoot kiest en Argument2 die overwrite kiest; de native runtime parst de bron vóór het wijzigen van de gekozen target

De runtime lost verse afstammings-writes en identity-publicatie op tegen de echt geïmporteerde native graaf, en past daarna dezelfde event-transactie en rollback toe als gewone veldmutaties

Related APIs

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