TXFAEventAction

Unit: HPDFXFAEventScript

Declaración

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

Comportamiento

Representa una operación literal parseada o una mutación validada emitida por el host de eventos general

Kind selecciona presence, raw value, access o una operación de instancia; los argumentos llevan índices y ajustes de instancia

El host general usa Target como referencia de binding y VirtualPath como la ubicación validada de un nodo creado durante el mismo evento

Los valores de action usan texto UTF-8; el Unicode inválido, los campos de action o los presupuestos rechazan el evento antes de la publicación del documento

Usa TXFAWidgetRuntime.DispatchEvent para replay y rollback validados en lugar de aplicar registros directamente a un documento compartido

Los bindings de identidad y los resultados de script usan Value para su texto validado y son interpretados por el runtime en lugar de tratarse como mutaciones de formulario ordinarias

Las actions de estado del host llevan texto name|value en Value; las actions de focus llevan focus o clear, y las actions de reset de edición tienen un Value vacío con el target de campo seleccionado

PropertyPath direcciona una propiedad debajo del dueño de formulario seleccionado por Target, usando ocurrencias de clase como font[0]/fill[0]/color[0]; se puede combinar con VirtualPath cuando el dueño se insertó durante el evento actual

Un PropertyPath vacío preserva el target de binding directo existente; el runtime valida la profundidad de la ruta, la cardinalidad del schema, los grupos choice y los presupuestos de nodos nativos antes de aplicar la creación o escrituras posteriores

DataPath identifica un descendiente del Data DOM recién creado por importación XML debajo del binding de datos seleccionado por Target, usando posiciones de hijos elemento base cero como 0/1; el texto, los comentarios y las instrucciones de procesamiento no cuentan como posiciones de elemento

DataPath puede acompañar a VirtualPath cuando el grupo de datos propietario fue creado por un form instance manager durante el evento actual

xeakLoadDataXML transporta el XML UTF-8 entrante en Value, con Argument seleccionando ignoreRoot y Argument2 seleccionando overwrite; el runtime nativo parsea el source antes de cambiar el target seleccionado

El runtime resuelve las escrituras de descendientes nuevos y la publicación de identidad contra el grafo nativo importado real, y luego aplica la misma transacción de eventos y rollback que las mutaciones ordinarias de campos

APIs relacionadas

Runtime interactivo de widgets XFA dinámico, Funciones FormCalc y Packet DOM de XFA