Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
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.
Ű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.
Kapcsolódó cikkek
Az ügyfél API-objektummodelljének ismertetése
Ügyfél API végrehajtási környezete
Események (ügyfél API-referencia)