Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Открытие экранной формы по идентификатору

Идентификатор формы (UUID) — это уникальный идентификатор, который автоматически присваивается каждой экранной форме при её создании. UUID используется для программного обращения к форме из кода, например — для её открытия в рантайме.

Как получить идентификатор формы

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

  • Через Редактор свойств:
    1. Откройте Редактор свойств нужной формы.
    2. Найдите свойство Идентификатор.

    3. Скопируйте значение UUID из этого поля.
  • Через свойство базового типа формы:

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

    Text_1.Text = BaseTypeUuid;
  • Из файла формы:
    1. Перейдите в папку проекта objects.
    2. Найдите файл формы с расширением .omobj, например, MainForm.omobj.
    3. Откройте файл в текстовом редакторе.
    4. Скопируйте значение атрибута UUID из первой строки XML, например:

      display-name="MainForm" uuid="1162610c-98c4-4f16-b534-5c03f178d25d" base-type="Form"

Как открыть форму по идентификатору

Ниже приведен пример настройки открытия целевой формы из главной по её UUID с использованием уведомляющего поля.

  1. Создайте целевую экранную форму. Для этого в Библиотеке компонентов во вкладке Проект щёлкните правым кликом мыши на Экранные формы → Создать форму. 

  2. Получите идентификатор созданной формы одним из способов, описанных в разделе Как получить идентификатор формы , и сохраните его — он понадобится далее.

  3. Перейдите на главную форму и добавьте уведомляющее поле типа string для хранения идентификатора формы. Для этого в Структуре объекта правой кнопкой мыши щелкните на MainForm → Создать.
    1. В открывшемся мастере создания элементов:
      1. В поле Тип элемента выберите Уведомляющее поле;
      2. В поле Базовый тип элемента выберите Уведомляющий string;
      3. Нажмите Создать.

    2. Назовите поле, например, Form_id.
  4. Настройте обработчик события ValueChanged для уведомляющего поля:
    1. Тип обработчика: Открыть в новом окне.

    2. Что открывать: Форма по идентификатору.

    3. Свяжите идентификатор целевой формы с уведомляющим полем:
      1. В дереве обработчика разверните узел Handler_1.

      2. Щёлкните правой кнопкой мыши на свойство Идентификатор объекта.

      3. Выберите Сослаться → Form_id.

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

  5. Добавьте на главную форму компонент, который будет инициировать открытие формы, например Кнопка.

  6. В обработчике события ButtonPressed для кнопки присвойте уведомляющему полю Form_id значение UUID нужной формы:

    Form_id = "3da535b3-ad5f-45ed-8fd0-2c4022d34151";// UUID формы, которую нужно открыть

В результате при нажатии на кнопку в рантайме:

  1. Значение поля Form_id изменяется на UUID целевой формы.
  2. Изменение значения поля активирует обработчик события ValueChanged.
  3. Обработчик открывает форму с указанным идентификатором в новом окне.