Megosztás:


Események a modellalapú alkalmazások űrlapjaiban és rácsaiban

Az események minden ügyféloldali kódot elindítanak. A modellalapú alkalmazásokban egy adott függvényt társít egy JavaScript-kódtárhoz (szkript webes erőforrás), amely esemény bekövetkezésekor lesz végrehajtva. Ezt a függvényt eseménykezelőnek nevezzük. Minden eseménykezelő egyetlen függvényt határoz meg egy JavaScript-kódtáron belül, és minden paramétert, amely átadható a függvénynek.

Az eseménykezelőket csak bizonyos eseményekhez társíthatja a felhasználói felületen. A felhasználói felületen keresztül nem társítható események esetén az Ügyfél API olyan metódusokat biztosít, amelyekkel eseménykezelőket csatolhat az ilyen eseményekhez.

Eseménykezelő függvény hozzáadása vagy eltávolítása az eseményhez felhasználói felületen

Az Űrlap tulajdonságai párbeszédpanel Eseménykezelők szakaszával társíthatja a szkriptet egy űrlapokhoz és oszlopokhoz tartozó eseményhez.

Eseménykezelő szakasz az Űrlap tulajdonságai területen.

Űrlapok tömeges szerkesztése

Alapértelmezés szerint az eseménykezelők nem lesznek meghívva, ha egy űrlap tömeges szerkesztési módban van.

Ha tömeges szerkesztési módban szeretné engedélyezni az eseménykezelőt, módosítsa az űrlap XML-fájlját a megfelelő event elem megkeresésével és az BehaviorInBulkEditForm attribútum Enabledlétrehozásával/beállításával. Ez jelenleg csak az OnLoad-események esetében támogatott.

Az űrlap XML-testreszabásáról további információt a Testreszabási fájl, azŰrlapok testreszabása és az Űrlap XML-sémájának szerkesztésekor című témakörben talál.

Annak megállapításához, hogy egy eseménykezelő mikor hívható meg egy űrlapon tömeges szerkesztési módban, használja getFormType a metódust.

Eseménykezelő függvény hozzáadása vagy eltávolítása az eseményhez kóddal

Az alábbi módszerekkel adhat hozzá és távolíthat el eseménykezelőt a felhasználói felületen keresztül nem társítható eseményekhez:

Events Eseménykezelő
Attribútum onChange addOnChange és removeOnChange metódusok
Űrlap betöltése formContext.ui addOnLoad és removeOnLoad metódusok
Betöltött űrlap formContext.ui addLoaded és removeLoaded metódusok
Űrlapadatok betöltése formContext.data addOnLoad és removeOnLoad metódusok
Űrlap mentése addOnSave és removeOnSave metódusok
Keresési vezérlő – Előszearchia addPreSearch és removePreSearch metódusok
kbsearch control OnResultOpened addOnResultOpened és removeOnResultOpened metódusok
kbsearch control OnSelection addOnSelection és removeOnSelection metódusok
kbsearch control PostSearch addOnPostSearch és removeOnPostSearch metódusok

Fontos

A végrehajtási környezet automatikusan át lesz adva első paraméterként a kóddal beállított függvények számára. További információ: Ügyfél API végrehajtási környezete

Űrlapesemény-folyamat

Minden eseményhez legfeljebb 50 eseménykezelőt definiálhat. A rendszer minden eseménykezelőt az Űrlaptulajdonságok párbeszédpanel Eseménykezelők szakaszában megjelenő sorrendben hajt végre.

A setSharedVariable és a getSharedVariable metódusok használatával adjon át egy közös változót az eseménykezelők (függvények) között. A getDepth végrehajtási környezettel megismerheti az eseménykezelő más eseménykezelőkhöz viszonyított végrehajtási sorrendjét.

Az ügyfél API-objektummodelljének ismertetése
Ügyfél API végrehajtási környezete
Események (ügyfél API-referencia)