Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
События инициируют весь клиентский код. В приложениях, управляемых моделью, вы связываете определенную функцию в библиотеке JavaScript (веб-ресурс скрипта), выполняемой при возникновении события. Эта функция называется обработчиком событий. Каждый обработчик событий задает одну функцию в библиотеке JavaScript и любые параметры, которые можно передать в функцию.
Обработчики событий можно связать только с некоторыми событиями с помощью пользовательского интерфейса. Для событий, которые недоступны для связи с помощью пользовательского интерфейса, клиентский API предоставляет методы, которые можно использовать для присоединения обработчиков событий к таким событиям.
Добавление или удаление функции обработчика событий в событие с помощью пользовательского интерфейса
Используйте раздел "Обработчики событий " диалогового окна "Свойства формы ", чтобы связать скрипт с событием для форм и столбцов.
Формы массового редактирования
По умолчанию обработчики событий не вызываются, когда форма находится в режиме массового редактирования.
Чтобы включить обработчик событий в режиме массового редактирования, измените XML формы, найдя соответствующий event элемент и создав или задав атрибутEnabled.BehaviorInBulkEditForm В настоящее время это поддерживается только для событий OnLoad.
Дополнительные сведения о настройке XML формы см. в разделе "Изменение файла настроек", "Настройка форм" и схемы XML формы.
Чтобы определить, когда обработчик событий вызывается в форме в режиме массового редактирования, используйте getFormType метод.
Добавление или удаление функции обработчика событий в событие с помощью кода
Использование следующих методов для добавления и удаления обработчика событий для событий, которые не могут быть связаны с помощью пользовательского интерфейса:
| Events | Обработчик событий |
|---|---|
| Атрибут OnChange | Методы addOnChange и removeOnChange |
| Форма OnLoad | методы formContext.ui addOnLoad и removeOnLoad |
| Загруженная форма | методы addLoaded и removeLoaded formContext.ui |
| Данные формы OnLoad | методы formContext.data addOnLoad и removeOnLoad |
| Форма onsave | Методы addOnSave и removeOnSave |
| Элемент управления lookup preSearch | Методы addPreSearch и removePreSearch |
| элемент управления kbsearch OnResultOpened | Методы addOnResultOpened и removeOnResultOpened |
| элемент управления kbsearch OnSelection | Методы addOnSelection и removeOnSelection |
| элемент управления kbsearch PostSearch | Методы addOnPostSearch и removeOnPostSearch |
Это важно
Контекст выполнения автоматически передается в качестве первого параметра функциям, заданным с помощью кода. Дополнительные сведения: контекст выполнения КЛИЕНТСКОго API
Конвейер событий формы
Для каждого события можно определить до 50 обработчиков событий. Каждый обработчик событий выполняется в том порядке, в котором он отображается в разделе "Обработчики событий " на вкладке "События " диалогового окна "Свойства формы ".
Используйте методы setSharedVariable и getSharedVariable для передачи общей переменной между обработчиками событий (функциями). Используйте метод getDepth контекста выполнения, чтобы узнать последовательность выполнения обработчика событий относительно других обработчиков событий.
Связанные статьи
Общие сведения об объектной модели клиентского API
Контекст выполнения API клиента
События (справочник по API клиента)