Описание обработчиков событий для компонента экранной формы

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

Вы можете генерировать блоки кода для описания обработчиков событий для компонентов экранной формы. Например, вы можете генерировать блоки кода для решения следующих задач:

• описание перехода между экранными формами проекта;
• управления переменными состояния экранной формы;
• выполнение действий, перечисленных в настройках источника данных на вкладке События;
• переход к экранной форме любого проекта в экземпляре согласно настроенным параметрам маршрутизации.

Для описания обработчика события вы можете сгенерировать несколько блоков кода и скомпоновать их в единый блок.

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

1. В проекте выберите файл с расширением mdcontainer, соответствующий экранной форме, на которой вы хотите описать обработчик события для компонента.

2. В Редакторе Форм, который открывается в рабочей области в визуальном режиме, выберите компонент.

   В правой части рабочей области на панели Свойства в блоке События отображаются имена обработчиков событий для компонента со значениями Not used.

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

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

   • func: введите функцию на JavaScript. В этом поле ввода доступны стандартные возможности редактора кода Monaco Editor, например, подсветка ошибок синтаксиса, раскрытие и скрытие блоков кода.

   • snip: если вы хотите сгенерировать блок кода для описания обработчика события, справа от snip нажмите + и из раскрывающегося списка, который отображается, выберите один из вариантов в зависимости от типа задачи, которую должен решать блок кода:

     • StaticLink: переход к экранной форме с заданным именем. Из раскрывающегося списка выберите имя экранной формы, к которой нужно перейти в разрабатываемом приложении.

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

     • DataSource: выполнение действий из списка на вкладке События в окне настройки источника данных. Из раскрывающегося списка выберите имя события.

     • URL: переход к экранной форме с настроенными параметрами маршрутизации. Из раскрывающегося списка с функцией автозаполнения выберите значение, соответствующее части URL-адреса и настроенное для экранной формы одного из проектов в текущем экземпляре Платформы. Если выбранная или введенный часть URL-адреса содержит параметр, в этой же строке справа нажмите значок (Карандаш) и введите значение параметра как константу или укажите переменную состояния экранной формы.

     В файл описания экранной формы будет добавлен блок кода согласно выбранному варианту.

     Если вы хотите, чтобы обработчик события решал несколько задач, рядом со списком snip нажмите + и повторите выбор варианта, как описано выше.

     Если вы добавили несколько блоков кода и хотите изменить порядок их выполнения, в списке snip с помощью мыши расположите их в нужном вам порядке.

4. Вверху справа нажмите Сохранить.

к сведению

Вы также можете описать обработчик события для компонента в Редакторе Форм в режиме редактирования кода. Информация о типах компонентов, которые можно добавить на экранную форму, свойствах и обработчиках событий этих компонентов доступна на демонстрационной странице Платформы в разделе Компоненты или в Справочнике компонентов экранных форм.

Теперь вы можете настроить или изменить свойства компонентов.