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