TXFAEventBinding

Enhet: HPDFXFAEventScript

Deklaration

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;

Beteende

Beskriver en virtuell händelsevärdnod; varje faktisk upprepad subformförekomst får en egen bindning och egna barn

ParentIndex väljer föräldrabindningen, eller -1 för roten; Value, Presence och Access beskriver förekomstens aktuella tillstånd

InstanceGroup identifierar bindningar som hanteras av samma instanshanterare, medan InstanceCount och förekomstgränser beskriver hanterarens omfattning

Mallstandardvärden initierar nya instanser; Repeated identifierar noder med en occur-deklaration

TXFAWidgetRuntime bygger dessa poster från mallen och den aktuella datamängdskontexten före motorkörningen

Identity är den stabila värdidentiteten för denna förekomst; ScriptSource innehåller JavaScript för ett skriptobjekt deklarerat inuti variables

En tom Identity använder en unik bindningsindex-identitet; ange stabila explicita identiteter när bindningsordningen kan ändras, så att kvarhållna referenser fortsätter att adressera samma förekomst

Locale bär nodens valfria locale-attribut som UTF-8-text; den körande noden ärver närmaste icke-tomma förfädervärde, och en tom kedja väljer användarens locale

EventActivity ger xfa.event.name för den körande bindningen; TXFAWidgetRuntime sätter händelseaktiviteter och kontextnamn för calculate eller validate, medan tomma bindningar på lägre nivå använder event

Domain skiljer formulärnoder från nativa datasets-, dataGroup- och dataValue-noder; standardvärdet xebdForm bevarar befintliga anropare

DataIdentity refererar en annan bindnings stabila identitet för att koppla ett formulärfält eller en subform till sin datanod; fält- och datavärdeläsningar delar sedan ett levande värde

DataBindingEnabled tillåter implicit skapande av datanoder när en upprepad formulärprototyp saknar befintlig databindning; runtime-fält med bind match=none lämnar den False och exponerar ingen syntetisk datanod

InstanceGroup på datadomänen registrerar syskonförekomsten med samma namn för nativ publicering av virtuella mål; databindningar exponerar inte formulärinstanshanterare

Attributes innehåller effektiva aktuella egenskapsattribut; DefaultAttributes innehåller mallattribut som används för en nyligen klonad egenskapsnod

Name på egenskapsdomänen behåller det faktiska namnattributet, vanligtvis tomt; dess ClassName ger SOM-komponenten och dess förälderindex bevarar egenskapshierarkin och lokala syskonförekomster

PropertyPath och PropertyOwnerIndex identifierar en formulärexklusiv egenskap som saknas i mallen; sökvägen använder komponenter med klassförekomster, och ägarindexet väljer den nativa formulärförekomsten i samma bindningsarray

Formulärexklusiva runtime-bindningar exponerar aktuella nativa attribut medan deras DefaultAttributes använder schemastandardvärden, så att kloning av en upprepad prototyp skapar standardegenskapsvärden i stället för att ärva en annan instans överskrivning

Lämna PropertyPath tom för befintliga bindningar till deklarerade egenskaper; det associerade ägarindexet används då inte

För exData är XML det aktuella serialiserade UTF-8-elementet och DefaultXML ger mallinnehåll för en ny upprepad instans

En exData-bindning med tom XML startar från ett tomt nativt exData-element; formulärexklusiv DefaultXML förblir tom så att en ny förekomst inte ärver en annan instans importerade främmande innehåll

XML-indatasträngar ingår i händelsekontextens bytebudget; saveXML och loadXML använder verifierad nativ svars-replay och publicerar via xeakLoadXML

XML på datadomänen bär runtimens begränsade grunda nativa XML-metadata: elementnamn, namespace, värde, attribut, namespace-deklarationer, ordnat icke-textinnehåll och barnpositioner; DefaultXML används inte för datanoder

Metadatan innehåller en nod och dess direkta barn av typen text, kommentar och processinstruktion, vilket undviker ett duplicerat ättlingdeltree för varje databindning

DataBindingRef är den trimmade dataRef-väljaren; DataBindingExplicit skiljer en explicit tom dataRef från en implicit fältnamnsbindning

DataContextIdentity identifierar fältets faktiska nativa datascope oberoende av DataIdentity, som identifierar dess valda löv

Dessa fält låter XML-importer omvärdera bindningar mot den fräscha Data DOM omedelbart, inklusive nyligen tillgängliga mål samt val av ättlingar, jokertecken, klass och index

Vanliga program använder TXFAWidgetRuntime för att bygga nativa bindningar; anropare på lägre nivå kan utelämna XML-metadata för rena skalära datanoder och låta de nya bindningsfälten behålla sina standardvärden

Relaterade API:er

Interaktiv Dynamic XFA Widget Runtime, FormCalc-funktioner och XFA Packet DOM