Alpha.Community

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

Межоконное взаимодействие

В Alpha.HMI межоконное взаимодействие реализуется через передачу сообщений между формами с использованием компонентов Окружение: группа окон и Окружение: окно. Сообщения — это произвольные данные в строковом формате (например, "close" или "update_data").

  • Окружение: группа окон отправляет сообщения всем формам, которые связаны с этой группой через свойство Группа окон в компоненте Окружение: окно, или конкретной форме по её ID.
  • Окружение: окно принимает эти сообщения и позволяет обработать их в событии MessageReceived. Например, можно закрыть форму или запустить определённый сценарий.

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

Группа окон

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

Полученные сообщения обрабатывает Окружение: окно, а их обработка (например, закрытие формы) задаётся в событии MessageReceived.

Компонент невизуальный и виден только в области Структура объекта.

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

Окно

Компонент Окружение: окно позволяет форме получать сообщения от Окружение: группа окон и обрабатывать их в событии MessageReceived.

Компонент невизуальный и виден только в области Структура объекта.

Связь с группой задаётся через свойство Группа окон, а действия для форм прописываются в MessageReceived. Текущее количество открытых форм доступно через свойство Количество окон в группе компонента Окружение: группа окон.

Подробнее свойства и события компонента Окружение: окно описаны в справочном руководстве.

Как передавать сообщения формам для их закрытия в Alpha.HMI (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) использования компонентов Окружение: группа окон и Окружение: окно для передачи сообщений между формами в проекте Alpha.HMI (проект сделан на языке Alpha.Om).

В примере показано, как объединить три формы — MainForm (главная форма), Form_1 и Form_2 (зависимые формы) — в одну группу окон и настроить компонент Окружение: группа окон для отправки сообщений этим формам.

Сообщения имеют тип close и используются следующим образом:

  • Для закрытия всех форм сообщение отправляется с Form_1 или Form_2 с помощью метода SendToAll(), что приводит к закрытию всех форм в группе (MainForm, Form_1, Form_2).
  • Для закрытия одной формы сообщение отправляется с MainForm с помощью метода SendMessageByID(), указывая ID конкретной формы (Form_1 или Form_2), чтобы закрыть только её.

В результате будет подготовлен проект, в котором:

  • Кнопки Открыть Form_1 и Открыть Form_2 на MainForm открывают зависимые формы.
  • Кнопка Закрыть все формы на Form_1 и Form_2 закрывает все формы в группе.
  • Кнопка Показать ID на MainForm выводит список ID открытых форм.
  • Поле ввода и кнопка Закрыть по ID на MainForm закрывают форму по указанному ID.

Проект включает предварительно созданные формы: MainForm (главная форма), Form_1 и Form_2 (зависимые формы).

Настройка компонента Окружение: группа окон

Создайте глобальный объект и добавьте в него компонент Окружение: группа окон, чтобы обеспечить доступ к нему из любой формы проекта (MainForm, Form_1, Form_2)

Чтобы создать новый глобальный объект:

  1. В Библиотеке компонентов во вкладке Проект щёлкните правым кликом мыши на Глобальные объекты → Создать.
  2. В поле Базовый тип элемента выберите Не задан → Создать.

  3. Дважды щелкните на созданный глобальный объект, чтобы открыть его. Перетяните сюда из библиотеки компонентов Окружение: группа окон (он отобразится в области Структура объекта).

Открытие зависимых форм с главной формы

Формы Form_1 и Form_2 можно открыть с главной формы MainForm с помощью кнопок. В примере ниже показано, как добавить и настроить кнопки для запуска зависимых форм.

  1. На MainForm добавьте две кнопки.
  2. В свойстве Текст укажите:

    • Для первой кнопки: Открыть форму Form_1;
    • Для второй кнопки: Открыть форму Form_2.
  3. Для каждой кнопки настройте обработчик события ButtonPressed:

    • Тип обработчика: Открыть в новом окне;

    • Форма: Form_1 для первой кнопки, Form_2 для второй.

Теперь при нажатии на кнопки будут открываться зависимые формы.

Закрытие всех форм через сообщение

Все формы в группе можно закрыть одним сообщением, отправленным с Form_1 или Form_2. В примере ниже показано, как отправить сообщение через Окружение: группа окон и обработать его с помощью Окружение: окно.

  1. На MainForm добавьте компонент Окружение: окно.
  2. В свойстве Группа окон укажите ссылку на глобальный объект. Для этого щелкните правой кнопкой мыши по свойству Группа окон → Сослаться → Type_1.WindowGroup_1.

  3. В обработчике MessageReceived для компонента Окружение: окно добавьте код:

    if (messageType == "close") 
    ㅤㅤhere.Close();

    Этот код проверяет, что messageType равно close. Если условие выполнено, текущая форма закрывается.

  4. На Form_1 и Form_2 добавьте кнопку с текстом Закрыть все формы.
  5. В обработчике события ButtonPressed для кнопки на Form_1 и Form_2 добавьте код:

    Type_1.WindowGroup_1.SendToAll("close", "");  

    Функция SendToAll отправляет сообщение всем формам в группе. Так как обработчик MessageReceived на MainForm настроен на проверку messageType == "close", то главная форма закроется, что приведёт к закрытию всех зависимых форм.

Закрытие одной формы по её ID через сообщение

Конкретную форму можно закрыть с MainForm, указав её уникальный ID. В примере ниже показано, как вывести список ID открытых форм и отправить сообщение для закрытия выбранной формы.

  1. На Form_1 и Form_2 добавьте компонент Окружение: окно.

  2. Для каждого компонента Окружение: окно (на Form_1 и Form_2) в обработчике MessageReceived укажите код:

    if (messageType == "close") 
    ㅤㅤhere.Close();

    Этот код проверяет, что messageType равно close. Если условие выполнено, текущая форма закрывается.

  3. На MainForm добавьте:

    • Редактор текста для отображения списка ID форм.

    • Кнопку с текстом Показать ID.
  4. В обработчике события ButtonPressed для кнопки Показать ID добавьте код:

    TextEdit_1.Text = "";
    for(i: uint4 = 0; i < Type_1.WindowGroup_1.WindowCount; i += 1)
    {
    ㅤㅤwindowID: string = Type_1.WindowGroup_1.GetWindowIDbyIndex(i);
    ㅤㅤformName: string = "";
    ㅤㅤif(i == 0)
    ㅤㅤㅤㅤformName = "MainForm";
    ㅤㅤif(i == 1)
    ㅤㅤㅤㅤformName = "Form_1";
    ㅤㅤif(i == 2)
    ㅤㅤㅤㅤformName = "Form_2";
    ㅤㅤTextEdit_1.Text = TextEdit_1.Text + formName + ": " + windowID + "\n";
    }

    Этот код выводит имена форм и их ID в редактор текста.

  5. На MainForm добавьте:

    • Поле ввода для ввода ID окна.
    • Кнопку с текстом Закрыть по ID.
  6. В обработчике события ButtonPressed для кнопки Закрыть по ID добавьте код:

    Type_1.WindowGroup_1.SendMessageByID(LineEdit_1.Text, "close", "");

    Этот код отправляет сообщение только форме с указанным ID. Функция SendMessageByID передаёт сообщение с типом close, что приводит к закрытию соответствующего окна.