Події у формах і сітках у програмах на основі моделі

Події ініціює всі клієнтські коди. У програмах на основі моделі ви пов'язуєте певну функцію в бібліотеці JavaScript (веб-ресурсі Script) для виконання під час події. Ця функція називається обробником подій. Кожен обробник подій визначає одну функцію в бібліотеці JavaScript і будь-які параметри, які можна передати до функції.

Обробники подій можна пов'язувати лише з деякими подіями за допомогою інтерфейсу користувача. Для подій, які не можна пов'язати через інтерфейс користувача, API клієнта надає методи, які можна використовувати, щоб вкладати обробники подій до таких подій.

Додавання або видалення функції обробника подій до події за допомогою інтерфейсу користувача

Спадщина

Скористайтеся розділом Обробники подій діалогового вікна Властивості форми , щоб пов'язати сценарій із подією для форм і стовпців.

Єдиний інтерфейс

Щоб додати або видалити функції обробника подій до подій у новому уніфікованому інтерфейсі:

1. Перейти до Power Apps.

2. В області переходів ліворуч виберіть пункт Дані , а потім – Таблиці.

3. У списку таблиць виберіть таблицю, до якої потрібно додати обробники подій.

4. На панелі команд виберіть вкладку Форми , а потім виберіть форму, яку потрібно додати.

   

5. Виберіть вкладку Події . Зверніть увагу на обробники подій On Save (Під час збереження ) і On Load (Під час збереження) і On Load (Під час завантаження ).

   

6. Якщо потрібно додати обробник подій для події після змінення, виділіть стовпець і виберіть вкладку Подія .

   

Групове редагування форм

За замовчуванням обробники подій не викликаються, коли форма перебуває в режимі групового редагування.

Щоб увімкнути обробник подій у режимі групового редагування, змініть XML-форму, знайшовши відповідний event елемент і створивши або встановивши BehaviorInBulkEditForm атрибут на Enabled. Наразі ця функція підтримується лише для подій OnLoad.

Докладні відомості про настроювання XML форми див. в статті Змінення файлу настройок, настроювання форм і XML-схеми форми.

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

Додавання або видалення функції обробника подій до події за допомогою коду

За допомогою наведених нижче методів можна додати та видалити обробник подій для подій, які не можна пов'язати через інтерфейс користувача:

Події	Обробник подій
Атрибут onChange	addOnChange і removeOnChange methods
Вантаж форми	formContext.ui addOnLoad і removeOnLoad methods
Форма завантажена	formContext.ui addLoaded and removeLoaded methods
Дані форми OnLoad	formContext.data addOnLoad and removeOnLoad methods
Сповіщати форму	addOnSave і removeOnSave methods
Попередній пошук елемента керування підстановки	addPreSearch and removePreSearch methods
kbsearch control OnResultOpened	addOnResultOpened і removeOnResultOpened methods
kbsearch control OnSelection	addOnSelection and removeOnSelection methods
kbsearch control PostSearch	addOnPostSearch і removeOnPostSearch methods

Важливо

Контекст виконання автоматично передається як перший параметр функціям, установленим за допомогою коду. Додаткові відомості: Контекст виконання API клієнта

Конвеєр подій форми

Для кожної події можна визначити до 50 обробників подій. Кожен обробник подій виконується в тому порядку, у якому він відображається в розділі Обробники подій на вкладці Події діалогового вікна Властивості форми .

Використовуйте setSharedVariable і getSharedVariable , щоб передати спільну змінну між обробниками подій (функціями). Використовуйте метод getDepth контексту виконання, щоб знати послідовність виконання обробника подій відносно інших обробників подій.

Пов’язані статті

Розуміння моделі об'єкта Client API
Контекст виконання API клієнта
Події (довідник із інтерфейсу API клієнта)