TXFAEventBinding

Unit: HPDFXFAEventScript

Declaración

TXFAEventBinding= record
  Name, ClassName: AnsiString;
  ParentIndex: Integer;
  Value, Presence, Access: AnsiString;
  InstanceCount, InstanceGroup: Integer;
  MinInstances, MaxInstances: Integer;
  DefaultValue, DefaultPresence, DefaultAccess: AnsiString;
  Repeated: Boolean;
  Identity, ScriptSource, Locale, EventActivity: AnsiString;
  Domain: TXFAEventBindingDomain;
  DataIdentity: AnsiString;
  DataBindingEnabled: Boolean;
  Attributes, DefaultAttributes: TXFAEventAttributes;
  PropertyPath: AnsiString;
  PropertyOwnerIndex: Integer;
  XML, DefaultXML: AnsiString;
  DataBindingRef, DataContextIdentity: AnsiString;
  DataBindingExplicit: Boolean;
end;

Comportamiento

Describe un nodo host virtual de un evento; cada ocurrencia real repetida de subform recibe un binding y hijos separados

ParentIndex selecciona su binding padre, o -1 para la raíz; Value, Presence y Access describen el estado actual de la ocurrencia

InstanceGroup identifica los bindings administrados por el mismo instance manager, mientras que InstanceCount y los límites de ocurrencias describen las cotas del manager

Los valores por defecto de la plantilla inicializan las nuevas instancias; Repeated identifica los nodos con una declaración occur

TXFAWidgetRuntime construye estos records a partir de la plantilla y el contexto actual de datasets antes de la ejecución del engine

Identity es la identidad estable del host para esta ocurrencia; ScriptSource contiene el JavaScript de un script object declarado dentro de variables

Un Identity vacío usa una identidad única de índice de binding; suministra identidades explícitas estables cuando el orden de bindings puede cambiar, para que las referencias retenidas sigan apuntando a la misma ocurrencia

Locale porta el atributo locale opcional del nodo como texto UTF-8; el nodo en ejecución hereda el valor de ancestro no vacío más cercano, y una cadena vacía selecciona el locale del usuario

EventActivity suministra xfa.event.name para el binding en ejecución; TXFAWidgetRuntime establece las actividades de eventos y los nombres de contexto de calculate o validate, mientras que los bindings de nivel inferior vacíos usan event

Domain distingue los nodos de formulario de los nodos nativos datasets, dataGroup y dataValue; su valor por defecto xebdForm preserva a los llamadores existentes

DataIdentity referencia la identidad estable de otro binding para conectar un campo o subform de formulario a su nodo de datos; las lecturas de campo y de valor de datos comparten entonces un único valor en vivo

DataBindingEnabled permite la creación implícita de nodos de datos cuando un prototipo repetido de formulario no tiene binding de datos existente; los campos de runtime con bind match=none lo dejan en False y no exponen ningún nodo de datos sintético

El InstanceGroup del dominio de datos registra la ocurrencia hermana de mismo nombre para la publicación nativa del destino virtual; los bindings de datos no exponen instance managers de formulario

Attributes contiene los atributos de propiedades efectivos actuales; DefaultAttributes contiene los atributos de plantilla usados para un nodo de propiedades recién clonado

El Name del dominio de propiedades retiene el atributo name real, normalmente vacío; su ClassName suministra el componente SOM y sus índices de padre preservan la jerarquía de propiedades y las ocurrencias hermanas locales

PropertyPath y PropertyOwnerIndex identifican una propiedad exclusiva de formulario ausente en la plantilla; la ruta usa componentes de ocurrencia de clase, y el índice de propietario selecciona la ocurrencia nativa de formulario en el mismo array de bindings

Los bindings de formulario exclusivos de runtime exponen los atributos nativos actuales mientras sus DefaultAttributes usan valores por defecto del schema, de modo que clonar un prototipo repetido crea valores de propiedades por defecto en vez de heredar el override de otra instancia

Deja PropertyPath vacío para los bindings de propiedades declaradas existentes; su índice de propietario asociado queda entonces sin uso

Para exData, XML es el elemento UTF-8 serializado actual y DefaultXML suministra el contenido de plantilla para una nueva instancia repetida

Un binding exData con XML vacío parte de un elemento nativo exData vacío; el DefaultXML exclusivo de formulario queda vacío para que una nueva ocurrencia no herede el contenido externo importado de otra instancia

Los strings de entrada XML participan en el presupuesto de bytes del contexto del evento; saveXML y loadXML usan replay validado de respuestas nativas y publican mediante xeakLoadXML

El XML del dominio de datos porta los metadatos nativos shallow acotados del runtime: nombre de elemento, namespace, valor, atributos, declaraciones de namespace, contenido de no texto ordenado y posiciones de hijos; DefaultXML no se usa para nodos de datos

Los metadatos contienen un nodo y sus hijos directos de texto, comentarios y processing instructions, evitando duplicar el subárbol descendiente por cada binding de datos

DataBindingRef es el selector dataRef recortado; DataBindingExplicit distingue un dataRef vacío explícito de un binding implícito por nombre de campo

DataContextIdentity identifica el ámbito nativo real de datos del campo con independencia de DataIdentity, que identifica su hoja seleccionada

Estos campos permiten que las importaciones XML reevalúen los bindings contra el Data DOM fresco de inmediato, incluidos los destinos recién disponibles y las selecciones descendientes, con comodines, de clase e indexadas

Las aplicaciones normales usan TXFAWidgetRuntime para construir los bindings nativos; los llamadores de nivel inferior pueden omitir los metadatos XML para nodos de datos solo escalares y dejar los campos nuevos de binding en sus valores por defecto

APIs relacionadas

Interactive Dynamic XFA Widget Runtime, Funciones de FormCalc y XFA Packet DOM