TXFAEventBinding

Unit: HPDFXFAEventScript

Declaration

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;

Adfærd

Beskriver én virtuel event-host-node; hver faktisk gentaget subform-occurrence modtager en separat binding og børn

ParentIndex vælger dens parent-binding eller -1 for roden; Value, Presence og Access beskriver aktuell occurrence-tilstand

InstanceGroup identificerer bindinger styret af samme instance manager, mens InstanceCount og occurrence-grænser beskriver managerens grænser

Skabelonstandarder initialiserer nye instances; Repeated identificerer noder med en occur-erklæring

TXFAWidgetRuntime bygger disse records ud fra skabelonen og den aktuelle datasets-kontekst før motor-afvikling

Identity er den stabile host-identitet for denne occurrence; ScriptSource indeholder JavaScript for et script-objekt deklareret inde i variables

En tom Identity bruger en unik binding-indeks-identitet; lever stabile eksplicitte identiteter, når bindingsrækkefølgen kan ændre sig, så tilbageholdte referencer fortsætter med at adressere samme occurrence

Locale bærer nodens valgfrie locale-attribut som UTF-8-tekst; den afviklende node nedarver den nærmeste ikke-tomme forfader-værdi, med en tom kæde der vælger bruger-locale

EventActivity leverer xfa.event.name for den afviklende binding; TXFAWidgetRuntime sætter event-aktiviteter og calculate- eller validate-kontekstnavne, mens tomme lavniveau-bindinger bruger event

Domain adskiller formularnoder fra native datasets-, dataGroup- og dataValue-noder; dens standard xebdForm bevarer eksisterende kaldere

DataIdentity refererer en anden bindings stabile identitet for at forbinde et formularfelt eller en subform til dets datanode; felt- og dataværdi-læsninger deler da én live værdi

DataBindingEnabled tillader implicit data-node-oprettelse, når en gentaget formular-prototype ikke har eksisterende databinding; runtime-felter med bind match=none lader den være False og udstiller ingen syntetisk datanode

Data-domæne InstanceGroup registrerer same-name sibling-occurrence til native virtuel mål-publicering; data-bindinger udstiller ikke formular instance managers

Attributes indeholder effektive aktuelle property-attributter; DefaultAttributes indeholder skabelonattributter brugt til en nyligt klonet property-node

Property-domæne Name beholder den faktiske name-attribut, normalt tom; dets ClassName leverer SOM-komponenten, og dets parent-indeks bevarer property-hierarki og lokale sibling-occurrences

PropertyPath og PropertyOwnerIndex identificerer en formular-kun-property fraværende fra skabelonen; stien bruger klasse occurrence-komponenter, og owner-indekset vælger den native formular-occurrence i samme binding-array

Runtime formular-kun-bindinger udstiller aktuelle native attributter, mens deres DefaultAttributes bruger skemastandarder, så kloning af en gentaget prototype opretter standard property-værdier i stedet for at nedarve en anden instances override

Lad PropertyPath være tom for eksisterende deklarerede property-bindinger; dets tilknyttede owner-indeks er da ubrugt

For exData er XML det aktuelle serialiserede UTF-8-element, og DefaultXML leverer skabelonindhold til en ny gentaget instance

En exData-binding med tom XML starter fra et tomt native exData-element; formular-kun DefaultXML forbliver tom, så en ny instance ikke nedarver en anden instances importerede fremmede indhold

XML-inputstrenge deltager i event-kontekstens bytebudget; saveXML og loadXML bruger valideret native respons-replay og publicerer gennem xeakLoadXML

Data-domæne XML bærer runtime'ens afgrænsede lave native XML-metadata: elementnavn, namespace, værdi, attributter, namespace-erklæringer, ordnet ikke-tekst-indhold og barn-positioner; DefaultXML er ubrugt for data-noder

Metadataen indeholder én node og dens direkte tekst-, kommentar- og processing-instruction-børn og undgår en duplikeret efterkommer-subtræ pr. data-binding

DataBindingRef er den trimmede dataRef-selektor; DataBindingExplicit adskiller en eksplicit tom dataRef fra en implicit feltnavn-binding

DataContextIdentity identificere feltets faktiske native data-scope uafhængigt af DataIdentity, som identificerer dets valgte blad

Disse felter lader XML-importer gen evaluere bindinger mod den friske Data DOM straks, inklusive nyligt tilgængelige mål samt efterkommer-, wildcard-, klasse- og indekserede valg

Almindelige applikationer bruger TXFAWidgetRuntime til at bygge native bindinger; lavniveau-kaldere kan udelade XML-metadata for scalar-kun data-noder og lade de nye bindingsfelter stå på deres standardværdier

Relaterede API'er

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