Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
Udalosti spustia celý kód na strane klienta. V modelom riadených aplikáciách priradíte konkrétnu funkciu do knižnice JavaScript (webový prostriedok skriptu), ktorá sa má vykonať pri výskyte udalosti. Táto funkcia sa nazýva obsluha udalosti. Každý obsluha udalosti určuje jednu funkciu v rámci knižnice JavaScript a všetky parametre, ktoré možno odovzdať do funkcie.
Obsluhy udalostí môžete priradiť len k niektorým udalostiam pomocou používateľského rozhrania. Pre udalosti, ktoré nie sú k dispozícii na priradenie prostredníctvom používateľského rozhrania, klientske rozhranie API poskytuje metódy, ktoré možno použiť na priloženie obsluhy udalostí k takýmto udalostiam.
Pridanie alebo odstránenie funkcie obsluhy udalostí k udalosti pomocou používateľského rozhrania
Pomocou časti Obsluhy udalostí v dialógovom okne Vlastnosti formulára priraďte svoj skript k udalosti pre formuláre a stĺpce.
Formuláre na hromadnú úpravu
V predvolenom nastavení sa obsluhy udalostí nevolá, keď je formulár v režime hromadnej úpravy.
Ak chcete povoliť obsluhu udalosti v režime hromadnej úpravy, upravte XML formulár vyhľadaním príslušného event prvku a vytvorením/nastavením atribútu BehaviorInBulkEditForm na Enabled. V súčasnosti je to podporované len pre udalosti OnLoad.
Ďalšie informácie o prispôsobení formulára XML nájdete v téme Kedy upravovať súbor prispôsobení, Prispôsobenie formulárov a Schéma XML formulára.
Ak chcete určiť, kedy sa volá obsluha udalosti vo formulári v režime hromadnej úpravy, použite getFormType metódu .
Pridanie alebo odstránenie funkcie obsluhy udalostí k udalosti pomocou kódu
Pomocou nasledujúcich metód môžete pridať a odstrániť obsluhu udalostí pre udalosti, ktoré nie je možné priradiť prostredníctvom používateľského rozhrania:
| Udalosti | Obsluha udalostí |
|---|---|
| OnChange pre atribúty | metódy addOnChange a removeOnChange |
| OnLoad formulára | metódy formContext.ui addOnLoad a removeOnLoad |
| Načítaný formulár | metódy formContext.ui addLoaded a removeLoaded |
| OnLoad pre údaje formulára | metódy formContext.data addOnLoad a removeOnLoad |
| OnSave pre formuláre | metódy addOnSave a removeOnSave |
| Ovládací prvok vyhľadávania PreSearch | metódy addPreSearch a removePreSearch |
| kbsearch control OnResultOpened | metódy addOnResultOpened a removeOnResultOpened |
| ovládací prvok kbsearch onSelection | metódy addOnSelection a removeOnSelection |
| ovládací prvok kbsearch PostSearch | metódy addOnPostSearch a removeOnPostSearch |
Dôležité
Kontext spustenia sa automaticky odovzdá ako prvý parameter do funkcií, ktoré sú nastavené pomocou kódu. Ďalšie informácie: Kontext spustenia rozhrania Client API
Kanál udalosti formulára
Pre každú udalosť môžete definovať až 50 obsluhy udalostí. Každý obsluha udalosti sa vykoná v poradí, v akom sa zobrazuje v časti Obsluhy udalostí na karte Udalosti v dialógovom okne Vlastnosti formulára .
Na odovzdanie spoločnej premennej medzi obslužnými programami udalosti (funkciami) použite metódu setSharedVariable a getSharedVariable . Pomocou metódy getDepth v kontexte spustenia môžete poznať sekvenciu, v rámci ktorou sa obsluha udalostí vykonáva v porovnaní s ostatnými obslužnými programami udalostí.
Súvisiace články
Vysvetlenie objektového modelu klientskeho rozhrania API
Kontext spustenia rozhrania Client API
Udalosti (odkaz na rozhranie API klienta)