Alpha.Community

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

Формирование древовидной структуры данных

Древовидная структура — это способ организации данных в виде иерархии, где информация представлена узлами (родительскими элементами) и подузлами (дочерними элементами). Такой подход удобен для работы с иерархическими данными, например файловой системы, списка сигналов, навигации по формам.

Для отображения древовидной структуры используются следующие компоненты:

Наполнение данными из источника дерева с использованием колонок

Этот способ позволяет загрузить данные из источника (например, Окружение: браузер файлов) и отобразить их в виде древовидной структуры.

Ниже приведён пример настройки компонентов для отображения структуры файловой системы. Вам потребуются следующие компоненты:

  • Дерево — для визуализации иерархии данных.
  • Источник данных дерева — для получения данных из источника.
  • Колонки дерева — для отображения значений из столбцов таблицы.
  • Окружение: браузер файлов — для получения данных о файловой системе.

Как настроить источник данных дерева

  1. Добавьте на экранную форму объект типа Дерево.

  2. В Структуре объектов щелкните правой кнопкой мыши по компоненту Дерево→ Создать.

  3. В мастере создания элементов:

    1. Оставьте тип элемента как Экземпляр типа.
    2. Выберите Базовый тип элемента→ Источник данных дерева (раздел Визуальные) → нажмите Создать.

В результате в структуре объектов появится дочерний компонент — Источник данных дерева.

Как добавить колонки дерева

  1. В Структуре объектов щелкните правой кнопкой мыши по компоненту Источник данных дерева→ Создать.

  2. В мастере создания элементов:

    1. Оставьте тип элемента как Экземпляр типа.
    2. Выберите Базовый тип элемента→ Колонка дерева (раздел Визуальные) → нажмите Создать.

    3. В Структуре объектов появится новый дочерний компонент Колонка дерева.

    4. Создайте таким образом три колонки. Они появятся в структуре как TreeColumn_1, TreeColumn_2 и TreeColumn_3.

  3. Выберите каждую созданную колонку и настройте для неё следующие свойства:

    1. Идентификатор:

      • name для TreeColumn_1;
      • id для TreeColumn_2;
      • parent_id для TreeColumn_3.
    2. Тип колонки:

      • 1 для TreeColumn_1;
      • 2 для TreeColumn_2;
      • 3 для TreeColumn_3.

При необходимости можно добавить дополнительные колонки (например, размер файла или время создания). Подробнее см. в разделе Какие данные возвращает компонент.

Как выполнить запрос для получения данных и наполнить дерево

  1. Чтобы наполнить дерево данными, добавьте компонент-источник (например, Окружение: браузер файлов) как дочерний элемент для Источника данных дерева.

  2. Чтобы данные загружались сразу при открытии формы, настройте обработчик события Opened. Используйте метод, подходящий для типа источника, например, Browse для Окружение: браузер файлов. Пример кода:

    Tree_1.TreeDataSource_1.FileSystemBrowser_1.Browse("");

Ручное создание скрипта наполнения дерева

Скрипт для наполнения дерева указывается в обработчике событий. В примерах ниже используется обработчик Opened, который срабатывает при открытии формы.

Как подготовить столбцы

Чтобы подготовить столбцы в компоненте Дерево:

  1. Добавьте на форму компонент Дерево.
  2. Настройте следующие параметры для дерева:

    • Укажите количество столбцов с помощью свойства Число столбцов.

    • Задайте имена столбцов с помощью функции SetColumnName.

    • Настройте видимость столбцов через функцию SetColumnHidden.

    • Установите ширину столбцов с помощью функции SetColumnWidth.

      Tree_1.ColumnCount = 2; // Устанавливаем 2 столбца
      Tree_1.SetColumnName("Название", 0); // Задаём имя для первого столбца (индекс 0)
      Tree_1.SetColumnHidden(0, false); // Отображаем первый столбец (индекс 0)
      Tree_1.SetColumnWidth(0, 200); // Устанавливаем ширину первого столбца в 200 пикселей

Как вставить новый элемент

Элементы дерева могут быть корневыми (без родителя) или дочерними (привязанными к родителю).

Чтобы добавить корневой элемент:

  1. Объявите переменную для хранения идентификатора элемента (результат функции AddItem).

  2. Вызовите функцию AddItem, оставив первый аргумент пустым "".

  3. Укажите текст элемента во втором аргументе.

    root: var = Tree_1.AddItem("", "Корневой элемент"); // Пустой первый аргумент — без родителя

Как настроить внешний вид элемента дерева

Чтобы настроить внешний вид элемента:

  1. Используйте функцию SetItemBackground для установки фона.

  2. Используйте SetItemTextColor для изменения цвета текста.

  3. Используйте SetItemIcon для установки иконки.

    Tree_1.SetItemBackgroundColor(root, 0xffefefef, 0); // Устанавливаем светлый фон
    Tree_1.SetItemTextColor(root, 0xff000000, 0); // Устанавливаем черный цвет текста
    Tree_1.SetItemIconPath(root, "icon.ico", 0); // Устанавливаем иконку

Как вставить дочерний элемент

Дочерние элементы добавляются к существующим элементам, создавая иерархию.

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

  1. Используйте функцию AddItem, передав в первом аргументе идентификатор родителя, а во втором – текст дочернего элемента.

  2. Для вставки элемента в определённое место используйте InsertItem, указав идентификатор родителя, текст элемента и порядковый номер позиции.

    child: var = Tree_1.AddItem(root, "Дочерний элемент"); // Добавляем дочерний элемент к корневому элементу root
    Tree_1.InsertItem(root, "Элемент в начале", 0); // Вставляем элемент в начало списка дочерних элементов

Как привязать экранную форму к элементу

Чтобы элемент дерева открывал определённую форму, свяжите его с идентификатором формы (UUID). Для этого:

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

    • Из свойства Идентификатор:

      1. Найдите в свойствах формы свойство Идентификатор.
      2. Скопируйте значение из этого поля.
    • Из файла формы:

      1. Перейдите в папку проекта objects.
      2. Найдите файл формы с расширением *.omobj, например, MainForm.omobj.
      3. Откройте этот файл в текстовом редакторе.
      4. Скопируйте значение атрибута uuid из первой строки.
  2. Используйте функцию SetItemData, передав:

    • Идентификатор элемента (например, child);
    • UUID формы;
    • Номер столбца, в который будет записан UUID.

    Tree_1.SetItemData(child, "79b50928-4a5f-4b19-ad9a-6d75c8b2601f", 0); // Привязываем форму к дочернему элементу

Как очистить список

Чтобы удалить элемент вместе со всеми дочерними, используйте RemoveItem.

Tree_1.RemoveItem(root); // Удаляет root и все дочерние

Чтобы удалить только дочерние элементы, используйте RemoveChildren.

Tree_1.RemoveChildren(root); // Удаляет только дочерние элементы

Автоматическое создание скрипта наполнения дерева

Автоматическое создание скрипта доступно только в проектах, интегрированных с Alpha.DevStudio.

Автоматическое создание скрипта позволяет сгенерировать готовый код для наполнения дерева списком форм. После генерации скрипт можно скопировать и вставить в любой обработчик события (например, в обработчик Opened).

Как подготовить столбцы

Чтобы автоматически подготовить столбцы компонента Дерево:

  1. Добавьте на форму компонент Дерево.
  2. Укажите количество столбцов в свойстве Число столбцов компонента Дерево.

  3. Щёлкните правой кнопкой мыши на элементе Дерево в структуре объекта и выберите команду Создать скрипт наполнения дерева.
  4. В строке Путь к дереву укажите путь до компонента Дерево.

  5. Настройте параметры столбцов в диалоговом окне:

    1. В строке Имя столбца введите нужное имя для каждого столбца.

    2. Выберите вид имени в строке Описание:

      • Name – используется имя формы.

      • DisplayName – используется значение свойства формы Отображаемое имя.

    3. Установите флаги видимости столбцов.

  6. Нажмите кнопку Создать скрипт для генерации кода.

Сгенерированный код будет включать вызовы методов SetColumnName для задания имён столбцов дерева и SetColumnHidden для управления их видимостью.

Как вставить новый элемент

Чтобы добавить элементы в дерево:

  1. В окне автоматического создания скрипта выберите формы, которые будут добавлены в список. При этом будет учтена иерархия форм проекта.

  2. Нажмите кнопку Создать скрипт для генерации кода.

Код будет содержать вызов AddItem с идентификатором родительского элемента и текстом нового элемента. Для корневых элементов родительский идентификатор остаётся пустым (""), а для дочерних указывается идентификатор родителя. Метод SetItemText задаёт текст элемента, отображаемый в дереве.

Как привязать экранную форму к элементу

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

  1. В окне автоматического создания скрипта в строке Данные выберите GUID.

  2. Нажмите кнопку Создать скрипт для генерации кода.

Код будет содержать вызов AddItem с идентификатором родительского элемента и текстом нового элемента, а также вызов метода SetItemData, который привязывает уникальный идентификатор (GUID) экранной формы к элементу дерева.

Как отобразить список сигналов источника данных Alpha.Server с помощью древовидного списка (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) использования компонента Браузер источника АР в проекте Alpha.HMI (проект сделан на языке JavaScript).

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

В результате будет подготовлена форма, при открытии которой информация о структуре источника будет получена с Alpha.Server и отображена в виде древовидной структуры.

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

Настройка отображения сигналов в виде дерева

  1. Добавьте на экранную форму объект типа Дерево.

  2. В Структуре объектов щелкните правой кнопкой мыши по компоненту Дерево→ Создать.

  3. В мастере создания элементов:

    1. Оставьте Тип элемента как Экземпляр типа.

    2. Выберите Базовый тип элемента→ Источник данных дерева (раздел Визуальные) → нажмите Создать.

В результате в структуре объектов появится дочерний компонент — Источник данных дерева.

Добавление колонок дерева

  1. В Структуре объектов щелкните правой кнопкой мыши по компоненту Источник данных дерева→ Создать.

  2. В мастере создания элементов:

    1. Оставьте Тип элемента как Экземпляр типа.
    2. Выберите Базовый тип элемента→ Колонка дерева (раздел Визуальные) → нажмите Создать.
    3. В Структуре объектов появится новый дочерний компонент с названием Колонка дерева.

    4. Создайте таким образом пять колонок. Они появятся в структуре как TreeColumn_1, TreeColumn_2, TreeColumn_3, TreeColumn_4 и TreeColumn_5.

  3. Выберите каждую созданную колонку и настройте для неё следующие свойства:

    1. Идентификатор:

      • displayName для TreeColumn_1;
      • name для TreeColumn_2;
      • parentId для TreeColumn_3;
      • hasChildren для TreeColumn_4;
      • tag для TreeColumn_5.
    2. Тип колонки:

      • 1 для TreeColumn_1;
      • 5 для TreeColumn_2;
      • 3 для TreeColumn_3;
      • 6 для TreeColumn_4;
      • 5 для TreeColumn_5.

При необходимости можно добавить дополнительные колонки в зависимости от возвращаемых данных. Подробнее см. в разделе Какие данные возвращает компонент.

Добавление Браузера источника АР

  1. Для просмотра дерева сигналов добавьте на форму компонент Браузер источника АР дочерним Источнику данных дерева.

  2. В редакторе свойств у объекта Браузер источника АР укажите ссылку на добавленный ранее компонент Источник АР. Для этого нажмите правой кнопкой мыши по свойству Источник АР → Сослаться→ ApSource_1.

Выполнение запроса для получения данных и наполнение дерева

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

  1. В структуре объекта щелкните правой кнопкой мыши по MainForm и выберите Создать функцию.
  2. Назовите функцию, например, BrowseNode.
  3. В окне Редактор функций:

    • Оставьте тип возвращаемого значения как void (функция не будет возвращать данные).
    • Добавьте входные аргументы:

      • parentId: string;
      • rootPath: string.
    • В поле Тип действия выберите Выполнить код , затем нажмите Редактировать.

  4. Введите код:

    // Создание запроса для получения структуры сигналов
    var request = {
        "level": "children", // Запрашиваем дочерние узлы
        "rootPath": rootPath, // Путь к корневому узлу (пустая строка означает корень)
        "columns": [
            {"id": "displayName", "type": "attribute", "parameters": {"id": "displayName"}}, // Имя узла
            {"id": "name", "type": "attribute", "parameters": {"id": "name"}},             // Уникальный ID
            {"id": "parentId", "type": "custom", 'parameters': { 'type': "string", 'defaultValue': parentId }}, // ID родителя
            {"id": "hasChildren", "type": "attribute", "parameters": {"id": "hasChildren"}}, // Наличие дочерних узлов
            {"id": "tag", "type": "attribute", "parameters": {"id": "tag"}} // Тег узла
        ]
    };
    
    // Преобразование запроса в строку JSON
    var requestJson = JSON.stringify(request); // Выполнение метода Browse для получения данных и наполнения дерева
    Tree_1.TreeDataSource_1.ApSourceBrowser_1.Browse(requestJson);
  5. Для компонента Дерево добавьте обработчик события ItemExpanded, чтобы при раскрытии узла загружались его дочерние элементы. В обработчике вызовите функцию BrowseNode, передав идентификатор узла (itemId) и значение его тега (tag) из пятой колонки (индекс 4):

    BrowseNode(itemId,GetItemText(itemId, 4));
  6. Для формы MainForm добавьте обработчик события Opened, чтобы при открытии формы загружались корневые узлы дерева. В обработчике вызовите функцию BrowseNode с пустыми параметрами:

    BrowseNode("","");

Как организовать навигацию по экранным формам с помощью древовидного списка (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) реализации иерархической навигации между экранными формами в проекте Alpha.HMI с использованием компонента Дерево (проект сделан на языке Alpha.Om).

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

В результате будет подготовлена форма, где по нажатию кнопки появляется иерархический список экранных форм KP (контролируемых пунктов) и SW (задвижек), двойной клик по элементу дерева открывает связанную форму, при наведении курсора на элементы списка показываются подсказки, а клик на изображение добавляет его в отдельный столбец для выбранного элемента списка.

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

  • Контролируемые пункты: KP1, KP2, KP3.
  • Задвижки: SW1, SW2, SW3.

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

Создание скрипта для наполнения списка

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

    1. Укажите количество столбцов 2 с помощью свойства Число столбцов.

    2. Установите название первого и второго столбца с помощью функции SetColumnName.

    3. Определите 6 переменных (item_0 ... item_5) для хранения id элементов списка.

    4. Для элементов item_1, item_2 и item_3 в первом аргументе функции AddItem укажите item_0, чтобы добавить их внутрь КП1.

    5. С помощью функции SetItemText задайте имена для каждого элемента.

    6. Привяжите экранные формы к элементам списка с помощью функции SetItemData.

      // Устанавливаем количество столбцов (2)
      Tree_1.ColumnCount = 2;

      // Устанавливаем название первого столбца, который будет отображать название контролируемых пунктов
      Tree_1.SetColumnName("KP", 0);

      // Устанавливаем название второго столбца для отображения изображений
      Tree_1.SetColumnName("Изображения", 1);

      // Добавляем первый контролируемый пункт (КП1)
      item_0: var = Tree_1.AddItem("", "");
      Tree_1.SetItemText(item_0, "KP1", 0);
      Tree_1.SetItemData(item_0, "79b50928-4a5f-4b19-ad9a-6d75c8b2601f", 0);

      // Добавляем дочерние элементы (задвижки SW1, SW2, SW3) в КП1
      item_1: var = Tree_1.AddItem(item_0, "");
      Tree_1.SetItemText(item_1, "SW1", 0);
      Tree_1.SetItemData(item_1, "bd1009a5-f221-44a0-943e-4e29e90ee329", 0);
      item_2: var = Tree_1.AddItem(item_0, "");
      Tree_1.SetItemText(item_2, "SW2", 0);
      Tree_1.SetItemData(item_2, "a179d336-17f2-435b-83b0-7a4d8c1227f1", 0);
      item_3: var = Tree_1.AddItem(item_0, "");
      Tree_1.SetItemText(item_3, "SW3", 0);
      Tree_1.SetItemData(item_3, "652e63b9-bf8c-43b2-a970-a12cad9b5ba8", 0);

      // Добавляем второй контролируемый пункт (КП2)
      item_4: var = Tree_1.AddItem("", "");
      Tree_1.SetItemText(item_4, "KP2", 0);
      Tree_1.SetItemData(item_4, "ee31048b-8f80-458d-809e-be8121a2f4bd", 0);

      // Добавляем третий контролируемый пункт (КП3)
      item_5: var = Tree_1.AddItem("", "");
      Tree_1.SetItemText(item_5, "KP3", 0);
      Tree_1.SetItemData(item_5, "4fccc71c-d239-4e82-8703-f2a38dee8328", 0);

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

  1. Добавьте на главную форму уведомляющее поле Form_id типа string для хранения id формы.
  2. В обработчике события ItemDoubleClicked компонента Дерево присвойте уведомляющему полю значение, полученное из функции GetItemData выбранного элемента.

    Form_id = Variant.ToString(GetItemData(itemId, column), "0");
  3. В обработчике события ValueChanged для уведомляющего поля Form_id установите тип обработчика Открыть в новом окне и выберите Форма по идентификатору

  4. Чтобы при каждом изменении значения уведомляющего поля автоматически открывалась форма с указанным id, задайте ссылку на Form_id в свойстве Идентификатор объекта. Для этого нажмите правой кнопкой мыши на свойство Идентификатор объекта и выберите Сослаться → Form_id.

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

Добавление всплывающей подсказки

Чтобы при наведении курсора на элемент списка отображалась всплывающая подсказка, добавьте в обработчик ButtonPressed следующий код:

// Установка всплывающих подсказок для всех элементов списка
// Подсказка для КП1
Tree_1.SetItemTooltip(item_0, "Контролируемый пункт 1 - основной узел управления", 0);
// Подсказки для задвижек SW1, SW2, SW3 внутри КП1
Tree_1.SetItemTooltip(item_1, "Задвижка SW1 - первая задвижка КП1", 0);
Tree_1.SetItemTooltip(item_2, "Задвижка SW2 - вторая задвижка КП1", 0);
Tree_1.SetItemTooltip(item_3, "Задвижка SW3 - третья задвижка КП1", 0);
// Подсказка для КП2
Tree_1.SetItemTooltip(item_4, "Контролируемый пункт 2 - вспомогательный узел", 0);
// Подсказка для КП3
Tree_1.SetItemTooltip(item_5, "Контролируемый пункт 3 - резервный узел", 0);

Добавление изображения в отдельный столбец при клике

  1. Добавьте на форму компонент Изображение.
  2. В свойстве Файл изображения нажмите кнопку с тремя точками и выберите файл изображения.
  3. В обработчике события MouseClick для компонента Изображение добавьте код, чтобы при клике изображение отображалось в отдельном столбце:

    1. Укажите путь к изображению с помощью функции SetImagePath.

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

      // Получаем идентификатор выбранного элемента в дереве
      selectedItem: string = Tree_1.CurrentItem;
      // Устанавливаем путь к изображению с индексом 1
      // (файл "Readable.ico" должен находиться в папке ресурсов проекта)
      Tree_1.SetImagePath(1, "Readable.ico");
      // Отображаем изображение с индексом 1 в выбранном элементе дерева
      // selectedItem - идентификатор элемента, 1 - номер столбца, true - делаем изображение видимым, 1 - индекс изображения
      Tree_1.SetItemImageVisible(selectedItem, 1, true, 1);