События в формах и сетках в приложениях на основе модели

События в формах и сетках инициируют весь клиентский код в приложениях на основе модели. При возникновении события вы связываете определенную функцию в библиотеке JavaScript (веб-ресурс скрипта). Эта функция называется обработчиком событий. Каждый обработчик событий задает одну функцию в библиотеке JavaScript и любые параметры, которые можно передать в функцию.

Обработчики событий можно связать только с некоторыми событиями с помощью пользовательского интерфейса. Для событий, которые нельзя связать с помощью пользовательского интерфейса, клиентский API предоставляет методы, которые можно использовать для подключения обработчиков событий.

Добавление или удаление функций обработчика событий в формах с помощью пользовательского интерфейса

Единый интерфейс

Чтобы добавить или удалить функции обработчика событий для событий в новом едином интерфейсе:

1. Переход к Power Apps.

2. В области навигации слева выберите "Данные " и выберите "Таблицы".

3. В списке таблиц выберите таблицу, в которой нужно добавить обработчики событий.

4. Выберите вкладку "Формы" на панели команд и выберите форму, в которой нужно добавить обработчик событий.

   

5. Перейдите на вкладку "События ". Отображаются обработчики событий on Save and On Load .

   

6. Чтобы добавить обработчик событий для события изменения, выберите столбец и перейдите на вкладку "Событие ".

   

Наследие

Используйте раздел "Обработчики событий " диалогового окна "Свойства формы ", чтобы связать скрипт с событием для форм и столбцов.

Формы массового редактирования

По умолчанию обработчики событий не выполняются, когда форма находится в режиме массового редактирования.

Чтобы включить обработчик событий в режиме массового редактирования, измените XML формы, найдя соответствующий event элемент и создав или задав BehaviorInBulkEditForm атрибут Enabled. В настоящее время это поведение поддерживается только для событий OnLoad.

Дополнительные сведения о настройке XML формы см. в разделе "Изменение файла настроек", "Настройка форм" и схемы XML формы.

Чтобы определить, когда обработчик событий выполняется в форме в режиме массового редактирования, используйте getFormType этот метод.

Добавление или удаление функций обработчика событий с помощью кода КЛИЕНТСКОго API

Используйте следующие методы для добавления и удаления обработчиков событий для событий, которые нельзя связать с помощью пользовательского интерфейса:

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 клиента)