TXFAEventAction

Unité : HPDFXFAEventScript

Déclaration

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

Comportement

Représente une opération littérale parsée ou une mutation validée émise par le host d'événements général

Kind sélectionne presence, raw value, access ou une opération d'instance ; les arguments portent des indices et réglages d'instance

Le host général utilise Target comme référence de binding et VirtualPath comme emplacement validé d'un nœud créé pendant le même événement

Les valeurs d'action utilisent du texte UTF-8 ; un Unicode invalide, des champs d'action ou budgets rejettent l'événement avant la publication du document

Utilisez TXFAWidgetRuntime.DispatchEvent pour un replay et rollback validés plutôt que d'appliquer les records directement à un document partagé

Les bindings d'identité et résultats de script utilisent Value pour leur texte validé et sont interprétés par le runtime plutôt que comme des mutations de formulaire ordinaires

Les actions d'état de host portent du texte name|value dans Value ; les actions focus portent focus ou clear, et les actions de reset d'édition ont un Value vide avec le champ cible sélectionné

PropertyPath adresse une propriété sous le propriétaire de formulaire sélectionné par Target, en utilisant des occurrences de classe comme font[0]/fill[0]/color[0] ; elle peut être combinée avec VirtualPath quand le propriétaire a été inséré pendant l'événement courant

Un PropertyPath vide préserve la cible de binding directe existante ; le runtime valide la profondeur de chemin, la cardinalité de schéma, les groupes choice et les budgets de nœuds natifs avant d'appliquer une création ou des écritures ultérieures

DataPath identifie un descendant Data DOM frais créé par import XML sous le binding de données sélectionné par Target, en utilisant des positions d'enfants éléments base zéro comme 0/1 ; le texte, commentaires et instructions de traitement ne comptent pas comme positions d'éléments

DataPath peut accompagner VirtualPath quand le groupe de données propriétaire a été créé par un gestionnaire d'instances de formulaire pendant l'événement courant

xeakLoadDataXML porte le XML UTF-8 entrant dans Value, avec Argument sélectionnant ignoreRoot et Argument2 sélectionnant overwrite ; le runtime natif parse la source avant de changer la cible sélectionnée

Le runtime résout les écritures de descendants frais et la publication d'identité contre le graphe natif réellement importé, puis applique la même transaction d'événement et rollback que les mutations de champs ordinaires

API associées

Runtime de widgets XFA dynamique interactif, Fonctions FormCalc et Packet DOM XFA