Бележка
Достъпът до тази страница изисква удостоверяване. Можете да опитате да влезете или да промените директориите.
Достъпът до тази страница изисква удостоверяване. Можете да опитате да промените директориите.
Събитията инициират целия код от страна на клиента. В приложенията, управлявани от модел, свързвате определена функция в библиотека на JavaScript (скриптов уеб ресурс), която да се изпълнява, когато възникне събитие. Тази функция се нарича манипулатор на събития. Всеки манипулатор на събития задава една функция в библиотека на JavaScript и всички параметри, които могат да бъдат предадени на функцията.
Можете да свържете манипулаторите на събития само с някои събития с помощта на потребителския интерфейс. За събития, които не са налични за свързване чрез потребителски интерфейс, API на клиент предоставя методи, които могат да се използват за прикачване на манипулатори на събития към такива събития.
Добавяне или премахване на функция на манипулатора на събития към събитие с помощта на потребителски интерфейс
Използвайте секцията "Манипулатори на събития " на диалоговия прозорец "Свойства на формуляра ", за да асоциирате скрипта си със събитие за формуляри и колони.
Групово редактиране на формуляри
По подразбиране манипулаторите на събития не се извикват, когато формулярът е в режим на групово редактиране.
За да разрешите манипулатор на събития в режим на групово редактиране, променете XML на формуляр, като намерите съответния event елемент и създадете/настроите атрибута Enabledна BehaviorInBulkEditForm . В момента това се поддържа само за събития OnLoad.
За повече информация относно персонализирането на XML формуляр вижте Кога да редактирате файла за персонализации, персонализирането на формуляри и XML схемата на формуляра.
За да определите кога манипулатор на събитие се извиква във формуляр в режим на групово редактиране, използвайте getFormType метод.
Добавяне или премахване на функция на манипулатора на събития към събитие с помощта на код
С помощта на следните методи за добавяне и премахване на манипулатор на събития за събития, които не могат да бъдат свързани чрез потребителския интерфейс:
| Събития | Манипулатор на събитие |
|---|---|
| Атрибут OnChange | addOnChange и removeOnChange методи |
| Зареждане на формуляр | formContext.ui addOnLoad и removeOnLoad методи |
| Зареден формуляр | formContext.ui addLoaded and removeLoaded methods |
| Зареждане на данни на формуляр | formContext.data addOnLoad и removeOnLoad методи |
| Записване на формуляр | addOnSave и removeOnSave методи |
| Предварително търсене на справочна контрола | addPreSearch и removePreSearch methods |
| контрола kbsearch OnResultOpened | addOnResultOpened и removeOnResultOpened методи |
| контрола kbsearch OnSelection | addOnSelection и removeOnSelection методи |
| контрола kbsearch PostSearch | addOnPostSearch и removeOnPostSearch методи |
Важно
Контекстът на изпълнение автоматично се подава като първи параметър на функции, които са зададени с помощта на кода. Повече информация: Контекст за изпълнение на API на клиент
Канал за събитие на формуляр
Можете да дефинирате до 50 манипулатора на събития за всяко събитие. Всеки манипулатор на събития се изпълнява в реда, в който се показва в секцията Манипулатори на събития в раздела Събития на диалоговия прозорец Свойства на формуляра .
Използвайте набораSharedVariable и getSharedVariable , за да предадете обща променлива между манипулаторите на събития (функции). Използвайте метода getDepth на контекста за изпълнение, за да знаете последователността, в която се изпълнява манипулаторът на събития спрямо другите манипулатори на събития.
Свързани статии
Разбиране на обектния модел на клиентския API
Контекст за изпълнение на API на клиент
Събития (справка за API на клиент)