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

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

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

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

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

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

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

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

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

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

   

5. Перейдіть на вкладку Події . Відображаються обидва обробники подій Під час збереження та Під час завантаження .

   

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

   

Спадщина

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

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

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

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

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

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

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

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

Події	Обробник подій
Атрибут 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 клієнта)