Alpha.Community

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

Панель вкладок

Панель вкладок — компонент для организации переключения между несколькими экранными формами в пределах одного контейнера (фрейма). Каждая вкладка имеет индекс – порядковый номер позиции (нумерация начинается с 0). Индексы используются для обращения к конкретным вкладкам в коде.

Как настроить панель вкладок с переключением форм во фрейме (Демо-проект)

Ниже приведён пример (скачать его можно здесь) использования компонента Панель вкладок в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

Создание панели вкладок с переключением форм во фрейме

Переключение форм работает за счёт взаимодействия трёх компонентов:

  • Панель вкладок;
  • Фрейм;
  • Команда.

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

  1. Получает индекс выбранной вкладки.
  2. С помощью функции GetTabIdByIndex() определяет соответствующий идентификатор формы.
  3. Сохраняет его в уведомляющем поле CurrentTabId.
  4. Вызывает команду OpenTabAction, которая открывает форму во фрейме.

Процесс настройки можно разбить на четыре этапа:

  1. Подготовка компонентов — создание четырёх экранных форм (DefaultForm, ProcessOverviewForm, AlarmsForm, EquipmentForm) и добавление на главную форму панели вкладок, фрейма, уведомляющего поля CurrentTabId и команды OpenTabAction.
  2. Создание функции сопоставления — создание функции GetTabIdByIndex(), которая принимает индекс вкладки (int4) и возвращает идентификатор формы (string).
  3. Создание вкладок — создание четырёх вкладок функцией AddTab() при открытии главной формы.
  4. Настройка переключения форм — создание обработчика события CurrentTabChanged, который вызывает функцию GetTabIdByIndex() и команду OpenTabAction.

Подготовка компонентов

Создайте экранные формы и добавьте необходимые компоненты на главную форму.

  1. В Библиотеке компонентов во вкладке Проект щёлкните правым кликом мыши на Экранные формы → Создать форму.

  2. Создайте четыре формы с именами:

    • DefaultForm (форма, открывающаяся по умолчанию);

    • ProcessOverviewForm;

    • AlarmsForm;

    • EquipmentForm.

  3. Добавьте на MainForm следующие компоненты:

    1. Панель вкладок — для управления переключением между формами.

    2. Фрейм — контейнер, в котором будут отображаться формы.

    3. Уведомляющий string — для хранения идентификатора текущей формы:

      1. В Структуре объекта щёлкните правой кнопкой мыши на MainForm.

      2. Выберите Создать → Уведомляющее поле.

      3. Укажите тип Уведомляющий string. Присвойте понятное имя, например, CurrentTabId
    4. Команда — для открытия формы во фрейме.

  4. В обработчике события Invoked компонента Команда выберите:

    • Тип обработчика: Открыть во фрейме.
    • Что открывать: Форма по идентификатору.
    • Фрейм: Frame_1.
    • Идентификатор объекта: ссылка на добавленный ранее компонент CurrentTabId (щелкните правой кнопкой мыши по свойству Идентификатор объекта → Сослаться→ CurrentTabId).

Создание функции сопоставления

Создайте собственную функцию, которая будет возвращать идентификатор формы по индексу вкладки.

  1. В области Структура объекта правой кнопкой мыши щелкните на главной форме → Создать функцию.
  2. Назовите функцию, например, GetTabIdByIndex.
  3. Дважды щёлкните левой кнопкой мыши по созданной функции, чтобы открыть Редактор функции.

  4. В окне Редактор функции:

    1. Добавьте аргумент с именем index и типом int4.
    2. Установите тип возвращаемого значения string.
    3. Выберите тип действия Выполнить код.

    4. Нажмите кнопку Редактировать, чтобы открыть редактор кода. Пример реализации:

      Идентификаторы форм можно найти в свойстве Id каждой формы.

      if (index == 0) {
        return "53d9db33-25ff-4215-8a40-03c42877d86c"; // DefaultForm
      } else if (index == 1) {
        return "12f804a4-7aa2-43e7-92ce-d50eae6da7ee"; // ProcessOverviewForm
      } else if (index == 2) {
        return "329bc585-9b23-404b-85cb-4ddbb519cddc"; // AlarmsForm
      } else if (index == 3) {
        return "81da79ef-094c-49ea-a554-aadaa7690ee5"; // EquipmentForm
      } else {
        return "53d9db33-25ff-4215-8a40-03c42877d86c"; // DefaultForm
      }

Создание вкладок

Чтобы создать вкладки на панели, добавьте код в обработчике события AboutToOpenedглавной формы MainForm.

Используйте функцию AddTab() компонента Панель вкладок для создания четырёх вкладок:

TabBar_1.AddTab("DefaultForm");
TabBar_1.AddTab("ProcessOverviewForm");
TabBar_1.AddTab("AlarmsForm");
TabBar_1.AddTab("EquipmentForm");

Настройка переключения форм

Чтобы настроить автоматическое переключение форм при выборе вкладки, добавьте код в обработчике события CurrentTabChanged панели вкладок.

Используйте функцию GetTabIdByIndex() для получения идентификатора формы по индексу вкладки, сохраните результат в уведомляющем поле CurrentTabId и вызовите команду OpenTabAction:

CurrentTabId = GetTabIdByIndex(index);
OpenTabAction.Invoke();

Это обеспечит открытие соответствующей формы во фрейме при переключении между вкладками.

Настройка иконок и всплывающих подсказок вкладок

Чтобы задать иконки и всплывающие подсказки вкладок, добавьте код в обработчике события AboutToOpened главной формы.

  1. Используйте функцию SetTabIconPath() компонента Панель вкладок для установки пути к файлу иконки:

    Убедитесь, что файлы иконок существуют и находятся в папке resources проекта.

    // Настройка иконок для основных вкладок
    TabBar_1.SetTabIconPath(0, "default.png");
    TabBar_1.SetTabIconPath(1, "processOverview.png");
    TabBar_1.SetTabIconPath(2, "alarms.png");
    TabBar_1.SetTabIconPath(3, "equipment.png");
  2. Используйте функцию SetTabToolTip() компонента Панель вкладок для установки информативных подсказок:

    // Настройка всплывающих подсказок
    TabBar_1.SetTabToolTip(0, "Общая информация о проекте");
    TabBar_1.SetTabToolTip(1, "Обзор технологического процесса");
    TabBar_1.SetTabToolTip(2, "Список и состояние сигналов тревоги");
    TabBar_1.SetTabToolTip(3, "Состояние оборудования");

Реализация динамического добавления и удаления вкладок

Чтобы настроить динамическое создание и удаление вкладок:

  1. Добавьте компонент Поле ввода - для ввода названия новой вкладки.
  2. Добавьте две кнопки для добавления и удаления вкладок: в свойстве Текст первой укажите, например, Добавить вкладку, а второй — Удалить вкладку.

  3. Настройте обработчик события ButtonPressed для кнопки Добавить вкладку:

    newTabText: string = LineEdit_1.Text;
    if (newTabText != "") {
    ㅤㅤnewIndex: int4 = TabBar_1.AddTab(newTabText);
    ㅤㅤTabBar_1.SetTabToolTip(newIndex, "Новая вкладка: " + newTabText);
    ㅤㅤLineEdit_1.Text = "";
    }

    Новые вкладки по умолчанию открывают форму DefaultForm, так как функция GetTabIdByIndex() возвращает её идентификатор для всех неуказанных индексов (блок else).

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

  4. Настройте обработчик события ButtonPressed для кнопки Удалить вкладку:

    currentIndex: int4 = TabBar_1.CurrentTabIndex;
    if (currentIndex >= 0) {
    ㅤㅤTabBar_1.RemoveTab(currentIndex);
    }

Включение режима закрываемых вкладок

Для добавления кнопки закрытия (крестик) на вкладках:

  1. Добавьте на форму компонент Флажок и в свойстве Текст укажите, например, Закрываемые вкладки.
  2. В обработчике события StateChanged для компонента Флажок:

    TabBar_1.TabsClosable = Checkbox_1.State;

    После этого на вкладках появятся крестики, которые позволяют закрывать ненужные вкладки.

Управление видимостью вкладок

Для скрытия/показа вкладок без удаления:

  1. Добавьте кнопку и в свойстве Текст укажите, например, Переключить видимость.
  2. Добавьте компонент Текст, чтобы выводить список скрытых вкладок.
  3. Настройте обработчик события ButtonPressed для кнопки Переключить видимость:

    currentIndex: int4 = TabBar_1.CurrentTabIndex;

    // Переключаем видимость текущей вкладки
    isVisible: bool = TabBar_1.GetTabVisible(currentIndex);
    TabBar_1.SetTabVisible(currentIndex, !isVisible);

    // Собираем и отображаем список скрытых вкладок
    hiddenList: string = "";
    total:int4 = TabBar_1.TabCount;
    for (i: int4 = 0; i < total; i = i + 1) {
    ㅤㅤif (!TabBar_1.GetTabVisible(i)) {
    ㅤㅤㅤㅤif (hiddenList != "") hiddenList = hiddenList + ", ";
    ㅤㅤㅤㅤhiddenList = hiddenList + TabBar_1.GetTabText(i);
    ㅤㅤㅤㅤ}
    ㅤㅤ}
    if (hiddenList == "") {
    ㅤㅤText_1.Text = "Скрытые вкладки: отсутствуют";
    } else {
    ㅤㅤText_1.Text = "Скрытые вкладки: " + hiddenList;
    }

Изменение расположения панели вкладок

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

  1. Добавьте кнопку и в свойстве Текст укажите Изменить положение.
  2. Настройте обработчик события ButtonPressed для кнопки Изменить положение:

    // Переключение позиции вкладок по кругу (0->1->2->3->0)
    currentPos: int4 = TabBar_1.TabsPosition; // читаем текущее значение
    newPos: int4 = (currentPos + 1) % 4; // увеличиваем и берём по модулю 4
    TabBar_1.TabsPosition = TypeConvert.ToUint1(newPos); // записываем новую позицию

    posText: string = "";
    if (newPos == 0) posText = "сверху";
    else if (newPos == 1) posText = "снизу";
    else if (newPos == 2) posText = "слева";
    else posText = "справа";

    // Вывод статуса
    Text_1.Text = "Вкладки размещены " + posText;