В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 26)
-
Лицензирование Альфа платформы
-
Ключи Guardant
-
Ключи Sentinel
-
-
Правила брандмауэра
-
Настройка DCOM
-
Работа в ОС Linux
-
Alpha.Server 6.5 (ред. 2. Предварительная)
-
Alpha.Server
-
Основные механизмы
-
Приложения
-
Модули
-
Коммуникационные модули
-
Link
-
TCP Сервер
-
-
Modbus
-
Modbus RTU Опросчик
-
Настройка обмена данными со станцией
-
Modbus RTU Станция
-
Modbus TCP Опросчик
-
Modbus TCP Станция
-
-
OPC
-
OPC AE Сервер
-
Функциональные возможности
-
OPC DA
-
OPC DA Клиент
-
OPC DA Сервер
-
-
OPC HDA
-
OPC HDA Клиент
-
OPC HDA Сервер
-
-
OPC UA
-
OPC UA Клиент
-
Настройка обмена данными с OPC UA сервером
-
Установка безопасного соединения
-
Приложения
-
OPC UA Сервер
-
Сертификаты
-
Приложения
-
-
-
МЭК 60870-5
-
МЭК 60870-5-101 Опросчик
-
Приложения
-
МЭК 60870-5-101 Станция
-
МЭК 60870-5-104 Опросчик
-
МЭК 60870-5-104 Станция
-
-
Универсальный модуль Опросчик (Меркурий, DCON)
-
МЭК 61850 Клиент
-
Обмен данными с устройствами
-
Набор данных устройства и сигналы сервера
-
ПОРТАЛ Клиент
-
Настройка обмена данными с ППД
-
ТЭМ-104
-
Приложения
-
BACnet Клиент
-
Настройка обмена данными с устройством
-
Приложения
-
EtherNet/IP Сканер
-
Приложения
-
FINS Клиент
-
Настройка обмена данными с ПЛК
-
MDLC Клиент
-
Настройка обмена данными с устройством MDLC
-
MQTT Клиент
-
Настройка обмена данными
-
Siemens S7 Клиент
-
Настройка обмена данными с ПЛК
-
Приложения
-
SNMP Менеджер
-
SQL Клиент
-
Настройка обмена данными с источником
-
Приложения
-
UNET Клиент
-
-
Служебные модули
-
Клиент безопасности
-
Получение значений из Alpha.Security
-
Модуль вычислений
-
Модуль истории
-
Приложения
-
Подсистема резервирования
-
Data Buffer
-
NetDiag, NetDiag2
-
Приложения
-
ProcessMonitor
-
SMTP
-
Snapshot
-
Запись данных в файл-срез
-
Модули Syslog
-
Syslog Клиент
-
Syslog Сервер
-
Приложения
-
Приложения
-
-
Write VQT
-
FS Generator
-
-
-
Сервисные приложения
-
Конфигуратор
-
Статистика
-
Просмотрщик лога кадров
-
-
Alpha.AccessPoint 6.5 (ред. 2. Предварительная)
-
Alpha.Imitator 6.5 (ред. 2. Предварительная)
-
Приложения
-
Alpha.Historian 4.0 (ред. 3. Предварительная)
-
Устройство и принципы работы
-
Управление базами данных
-
Общие
-
4x
-
3x
-
-
Устаревшие разделы
-
Справочник
-
Настройки базы данных
-
Alpha.Domain 1.5 (ред. 1)
-
Принципы настройки подсистемы
-
Приложения
-
Alpha.DevStudio 4.2 (ред. 4. Предварительная)
-
Руководство пользователя
-
Знакомство с Alpha.DevStudio
-
Разработка проекта
-
Описание домена
-
Добавление компонентов домена
-
-
Добавление объектов
-
Описание объектов
-
Добавление атрибутов
-
-
Пользовательский интерфейс
-
Инструменты
-
Редакторы
-
-
Интерфейс командной строки
-
Справочник
-
Элементы
-
Автоматизация
-
ВНИИАЭС
-
Карты адресов
-
Коммуникационные модули
-
-
Гидроуклон
-
Служебные модули
-
-
Инконтрол
-
Инконтрол
-
-
Контроллеры Modicon
-
Modbus
-
Контроллеры
-
-
Контроллеры OMRON
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры REGUL
-
Modbus
-
OPC
-
Контроллеры
-
МЭК 60870-5
-
-
Контроллеры SIMATIC
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры ТРЭИ
-
Modbus
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Обобщенные устройства
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Общие элементы
-
Последовательная шина
-
Устройства
-
-
Программируемые логические контроллеры
-
Modbus
-
OPC
-
Контроллеры
-
-
Развёртывание
-
Компьютеры
-
Устройства
-
-
Связи
-
Ссылки
-
-
Сервер истории
-
Сети BACnet
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети CANopen
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети EtherNet/IP
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети Ethernet
-
Сети KNX
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
Устройства
-
-
Сети Link
-
Link
-
Карты адресов
-
-
Сети MDLC
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети MQTT
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Modbus
-
Modbus
-
Карты адресов
-
-
Сети NFL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети OPC
-
OPC
-
Карты адресов
-
-
Сети SMTP
-
Карты адресов
-
Служебные модули
-
-
Сети SNMP
-
Карты адресов
-
-
Сети SQL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Syslog
-
Карты адресов
-
Служебные модули
-
-
Сети МЭК 60870-5
-
Карты адресов
-
МЭК 60870-5
-
-
Сети МЭК 61850
-
Карты адресов
-
Устройства
-
-
ТПТС-НТ
-
Инконтрол
-
Контроллеры
-
-
Теплосчетчики ТЭМ
-
Карты адресов
-
Коммуникационные модули
-
Устройства
-
-
Уровень управления
-
Вычисления
-
-
Файловый обмен
-
Физический уровень
-
Элементы HMI
-
Элементы сервера
-
Карты адресов
-
Коммуникационные модули
-
Коммуникационные модули\Link
-
Коммуникационные модули\Modbus
-
Коммуникационные модули\OPC
-
Коммуникационные модули\МЭК 60870-5
-
Настройки по умолчанию
-
Служебные модули
-
-
-
Атрибуты
-
Om.BACnet
-
Om.CANopen
-
Om.EtherNetIP
-
Om.GenericDevices
-
Om.HMI
-
Om.Hydroslope
-
Om.IEC60870
-
Om.KNX
-
Om.MDLC
-
Om.MQTT
-
Om.OPC
-
Om.PLC
-
Om.Server
-
Om.System
-
-
-
Alpha.Security 1.7 (ред. 18)
-
LDAP-сервер и его настройка
-
Редактирование конфигурации на LDAP-сервере с помощью SecurityConfigurator
-
Приложения
-
Alpha.Om 1.4 (ред. 6. Предварительная)
-
Функции
-
Математические функции
-
Строковые функции
-
Функции обработки времени
-
Функции типа variant
-
-
Приложения
-
Alpha.HMI 2.0 (ред. 31. Предварительная)
-
Руководство пользователя
-
О продукте
-
Основные этапы работы с проектом
-
Запуск дизайнера
-
Запуск на исполнение
-
-
Разработка мнемосхем
-
Экранные формы
-
Компоненты
-
Графические примитивы
-
Готовые компоненты
-
-
Действия с объектами и экранными формами
-
Просмотр характеристик
-
Свойства объектов
-
Свойства в рантайме
-
Обработчики событий
-
Функции объектов
-
-
Заливка градиентом
-
Демонстрационный проект Резервуарный парк
-
-
Источники данных
-
OPC DA
-
TCP
-
Получение событий
-
-
Взаимодействие с окружением проекта
-
Приложения
-
Справочное руководство
-
Компоненты для работы с данными
-
Источник OPC
-
Элемент OPC
-
Источник AP
-
Элемент AP
-
Учетные данные АР
-
Браузер источника АР
-
Запрос алармов
-
Менеджер алармов
-
Запрос значений элемента AP
-
Запрос значений множества сигналов АР
-
Запрос значений сигналов АР
-
Очередь активных алармов
-
-
Компоненты окружения
-
Окружение: архиватор
-
Окружение: группа окон
-
Окружение: окно
-
Окружение: сеть
-
Окружение: файлы
-
Окружение: ошибка работы с файлами
-
Окружение: система
-
Окружение: запрос системного журнала
-
Окружение: браузер файлов
-
Окружение: процесс
-
Окружение: этот процесс
-
Окружение: переменные среды процесса
-
Текстовый файл
-
Оборудование: клавиатура
-
Оборудование: монитор
-
Снимок экрана
-
-
Компоненты для предоставления сервисных функций
-
Статистика: браузер
-
Статистика: JSON-браузер
-
Статистика: узел
-
Статистика: источник данных
-
-
Данные: агрегатор
-
Компоненты печати
-
Печать
-
Принтер
-
Системные принтеры
-
Размеры страницы
-
-
Компоненты для выполнения SQL-запросов
-
Источник SQL
-
Запрос источника SQL
-
Запрос SQL
-
-
Компоненты разметки
-
Линейная разметка
-
Плоская разметка
-
Вес элемента разметки
-
Ограничение размеров элемента разметки
-
Сворачивание элемента разметки
-
Выравнивание элемента разметки
-
Отступы элемента разметки
-
-
Графические компоненты
-
Линейный градиент
-
Радиальный градиент
-
Соединительная линия
-
Место соединения
-
Линия
-
Кривая линия
-
Прямоугольник
-
Эллипс
-
Изображение
-
Точка трансформации
-
-
Компоненты для построения пользовательского интерфейса
-
Индикатор гистограммы
-
Всплывающая подсказка
-
Уведомление
-
Перемещение
-
Кнопка
-
Курсор
-
Глобальный курсор
-
Полоса прокрутки
-
Панель вкладок
-
Системная кнопка
-
Флажок
-
Текст
-
Расширенный текст
-
Поле ввода
-
Редактор текста
-
Индикатор прогресса
-
Ползунок
-
Выпадающий список
-
Фрейм
-
-
Встраиваемые компоненты
-
Alpha.Alarms
-
Свойства
-
Функции
-
События
-
-
Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
-
Компоненты для проверки ввода и преобразования форматов
-
Входной формат
-
Выходной формат
-
Формат булевского значения
-
Формат даты/времени
-
Формат числа с плавающей запятой
-
Проверка ввода
-
Проверка ввода целого числа
-
Проверка ввода беззнакового целого числа
-
Проверка ввода числа с плавающей запятой
-
Проверка ввода регулярного выражения
-
-
Компоненты периодичного выполнения
-
Таймер
-
Мигание
-
Команда
-
Звук
-
Инициализатор
-
Сессия
-
-
Буфер обмена
-
Веб содержимое
-
Компоненты для работы с графиками
-
График: данные
-
График: декоратор линии
-
График: линия
-
График: ось
-
График: поле графика
-
График: реперная линия
-
График: точка пересечения
-
График: экспорт
-
-
Компоненты для формирования древовидной структуры
-
Дерево
-
Источник данных дерева
-
Колонка дерева
-
-
Экранные формы
-
Средство отладки
-
Менеджер проекта
-
Среда исполнения
-
-
Alpha.HMI.WebViewer 2.0 (ред. 31. Предварительная)
-
О продукте
-
-
Alpha.HMI - дополнительные модули
-
Alpha.HMI.Security 2.0 (ред. 15)
-
Руководство пользователя
-
Справочное руководство
-
Контекст безопасности (SecurityContext)
-
Список пользователей (UserList)
-
Настройка безопасности: Контроль целостности (SecurityIntegrityControl)
-
Числовой элемент безопасности (NumericTokenProxy)
-
Строковый элемент безопасности (StringTokenProxy)
-
Булевский элемент безопасности (BoolTokenProxy)
-
Настройка безопасности: Менеджер (SecurityManager)
-
Настройка безопасности: Приложение (SecurityManagerApplication)
-
Настройка безопасности: Пользователь (SecurityManagerUser)
-
Настройка безопасности: Группа (SecurityManagerGroup)
-
Мастер конфигурирования Security (Configurator)
-
Информация лицензирования: Получение (LicenseInfo)
-
-
-
Alpha.HMI.Tables 2.1 (ред. 1)
-
Построение таблицы модели данных
-
Справочник API
-
Таблицы
-
Таблица
-
Свойства
-
Функции
-
События
-
-
Таблица: декоратор
-
Свойства
-
-
Таблица: итератор
-
Свойства
-
Функции
-
-
Таблица: модель данных
-
Свойства
-
Функции
-
События
-
-
Таблица: столбец
-
Свойства
-
Функции
-
События
-
-
Таблица: устойчивый итератор
-
Функции
-
-
-
-
-
Alpha.HMI - библиотеки
-
Alpha.HMI.CommonLib 3.0 (ред. 2)
-
Руководство пользователя
-
Примеры использования компонентов расширения
-
Справочное руководство
-
Типы
-
Тема оформления
-
Конвертер значений
-
Утилиты для работы со строками
-
Утилиты для работы с окном
-
Утилиты для работы с файлами
-
Информация о продукте
-
Буфер аргументов события
-
Обработчик события
-
Пользовательская команда
-
Текстовые шаблоны
-
Редакторы
-
Редактор целого числа
-
Редактор даты
-
Редактор времени
-
Редактор интервала времени
-
Горизонтальный сплиттер
-
Вертикальный сплиттер
-
Рамка с ошибкой
-
Редактор даты и времени
-
-
Меню
-
Элемент меню
-
Результат выбора меню
-
-
Панель инструментов
-
Кнопка панели инструментов
-
Кнопка выпадающего списка
-
Разделитель панели инструментов
-
Панель поиска
-
Тема оформления панели инструментов
-
-
Строка статуса
-
Кнопка авторизации
-
Кнопка-индикатор журнала сообщений
-
Индикатор подключения к серверу
-
Кнопка вызова экранной клавиатуры
-
Параметры вызова экранной клавиатуры
-
-
Диалоги
-
Результат выбора папки
-
Результат выбора цвета
-
Результат выбора параметров подключения
-
Результат выбора даты и времени
-
Результат ввода значения
-
Результат редактирования колонтитула
-
Результат выбора файла
-
Результат диалога авторизации
-
Список файлов
-
Дерево сигналов
-
Журнал сообщений
-
Редактируемая таблица
-
Редактор ячейки таблицы
-
-
Экранные формы
-
Меню
-
Календарь
-
Сообщение
-
Диалог ввода значения
-
Диалог выбора цвета
-
Диалог подключения к серверу
-
Редактор колонтитула
-
Файлы
-
Диалог открытия файла
-
Диалог сохранения файла
-
Диалог выбора папки
-
-
Безопасность
-
Диалог авторизации пользователя
-
Диалог смены пароля
-
Диалог ввода учетных данных
-
-
Общие свойства компонентов библиотеки
-
-
-
-
Alpha.HMI - приложения
-
Alpha.HMI.AdminConsole 1.0 (ред. 3)
-
Руководство пользователя
-
Справочное руководство
-
Консоль администрирования
-
Инструментальная панель
-
Разрешения
-
AdminConsole_Page
-
-
-
Alpha.HMI.Alarms 3.3 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Привлечение внимания к важным событиям
-
Квитирование событий
-
Экспорт сообщений в файл
-
Справочное руководство
-
Alarms
-
Свойства
-
Функции
-
-
Alarms_Table
-
Свойства
-
Функции
-
-
Alarms_Sounds
-
Свойства
-
Функции
-
-
EventStatistics
-
Свойства
-
-
Разрешения пользователя
-
Свойства
-
Функции
-
-
-
-
Alpha.HMI.ComtradeViewer 1.1 (ред. 1)
-
Встраивание в проект
-
API
-
ComtradeViewer
-
Свойства
-
Функции
-
-
Разрешения (ComtradeViewer_Permissions)
-
Свойства
-
-
-
Alpha.HMI.Explorer 4.0 (ред. 2)
-
Руководство пользователя
-
Справочное руководство
-
Explorer_Form
-
-
Alpha.HMI.IntegrityControl 2.8 (ред. 1)
-
Руководство пользователя
-
Контроль целостности
-
Справочное руководство
-
IntegrityControl
-
IntegrityConfiguration
-
Разрешения
-
Настройки
-
IntegrityControl_KTN
-
IntegrityControl_Form
-
IntegrityConfiguration_Form
-
-
-
Alpha.HMI.SecurityConfigurator 4.0 (ред. 1)
-
Руководство пользователя
-
Редактирование конфигурации
-
Приложения
-
Справочное руководство
-
SecurityConfigurator
-
Настройки
-
Разрешения
-
SecurityConfigurator_Page
-
SecurityConfigurator_Form
-
-
-
Alpha.HMI.SetPoints 2.5 (ред. 2)
-
Руководство пользователя
-
Приложения
-
Справочное руководство
-
SetPoints
-
SetPoints_Settings
-
Разрешения
-
Тема оформления Уставок
-
SetPoints_Page
-
SetPoints_Form
-
-
-
Alpha.HMI.Statistics 1.2 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
Statistics
-
Разрешения
-
Настройки
-
Statistics_Form
-
-
-
Alpha.HMI.SystemLogViewer 2.0 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
SystemLogViewer
-
Разрешения
-
Тема оформления Журнала событий
-
SystemLogViewer_Form
-
-
-
Alpha.HMI.Trends 2.4 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Сохранение и загрузка данных
-
Справочное руководство
-
Свойства
-
Функции
-
-
-
-
Alpha.Alarms 3.30 (ред. 1)
-
Варианты запуска
-
Начало работы
-
Аспекты безопасности
-
Просмотр оперативных событий
-
Подавление и блокирование событий источника/объекта
-
Аналитика событий
-
Фильтрация сообщений о событиях
-
Дополнительные возможности
-
Работа со встраиваемым компонентом
-
Alarms-API
-
Свойства
-
Функции
-
События
-
-
-
Alpha.Trends 3.33 (ред. 3. Предварительная)
-
Начало работы
-
Просмотр значений сигналов
-
Аналитика графиков
-
Использование реперных линий
-
Вертикальные реперы
-
-
Вспомогательные функции
-
Работа со встраиваемым компонентом Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
Alpha.Tools 1.6 (ред. 8)
-
EventLogViewer
-
Приложения
-
OpcExplorer
-
Настройка и подключение к источнику данных
-
Просмотр адресного пространства
-
Приложения
-
-
Alpha.RMap 1.7 (ред. 2)
-
Приложения
-
Установка и настройка
-
-
Alpha.Diagnostics 2.2
-
Alpha.AuditReport
-
Настройка Alpha.AuditReport
-
Alpha.SystemMonitor
-
Интерфейс
-
Настройка
-
Alpha.Hashcheck
-
Настройка конфигурации
-
Alpha.NTPClient
-
Alpha.Utilities
-
Приложения
-
Alpha.Reports 1.1 (ред. 18)
-
Руководство администратора
-
Приложения
-
Конфигуратор
-
Конструктор отчётов
-
Описание интерфейса и функций программы
-
Приложения
-
Поддерживаемые функции
-
Текстовые
-
Числовые
-
Математические
-
Информационные
-
Логические
-
Поиск и ссылки
-
Дата и время
-
База данных
-
Финансовые
-
-
-
Библиотека
-
Функции библиотеки
-
Приложения
-
Просмотр отчётов
-
-
Alpha.SmartControl 9.3 (ред. 1)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Формирование древовидной структуры данных
Древовидная структура — это способ организации данных в виде иерархии, где информация представлена узлами (родительскими элементами) и подузлами (дочерними элементами). Такой подход удобен для работы с иерархическими данными, например файловой системы, списка сигналов, навигации по формам.
Для отображения древовидной структуры используются следующие компоненты:
-
Источник данных дерева используется для получения данных, которые будут отображаться в дереве. Данные представляются в виде невизуальной таблицы и могут поступать из различных источников:
- Колонка дерева используется для отображения значений из столбцов источника данных дерева.
- Дерево используется для графического отображения данных в виде древовидной структуры. Компонент Дерево поддерживает три способа наполнения данными:
Наполнение данными из источника дерева с использованием колонок
Этот способ позволяет загрузить данные из источника (например, Окружение: браузер файлов) и отобразить их в виде древовидной структуры.
Ниже приведён пример настройки компонентов для отображения структуры файловой системы. Вам потребуются следующие компоненты:
- Дерево — для визуализации иерархии данных.
- Источник данных дерева — для получения данных из источника.
- Колонки дерева — для отображения значений из столбцов таблицы.
- Окружение: браузер файлов — для получения данных о файловой системе.
Как настроить источник данных дерева
-
Добавьте на экранную форму объект типа Дерево.
-
В Структуре объектов щелкните правой кнопкой мыши по компоненту Дерево→ Создать.
-
В мастере создания элементов:
- Оставьте тип элемента как Экземпляр типа.
-
Выберите Базовый тип элемента→ Источник данных дерева (раздел Визуальные) → нажмите Создать.
В результате в структуре объектов появится дочерний компонент — Источник данных дерева.
Как добавить колонки дерева
-
В Структуре объектов щелкните правой кнопкой мыши по компоненту Источник данных дерева→ Создать.
-
В мастере создания элементов:
- Оставьте тип элемента как Экземпляр типа.
-
Выберите Базовый тип элемента→ Колонка дерева (раздел Визуальные) → нажмите Создать.
-
В Структуре объектов появится новый дочерний компонент Колонка дерева.
-
Создайте таким образом три колонки. Они появятся в структуре как TreeColumn_1, TreeColumn_2 и TreeColumn_3.
-
Выберите каждую созданную колонку и настройте для неё следующие свойства:
-
Идентификатор:
- name для TreeColumn_1;
- id для TreeColumn_2;
- parent_id для TreeColumn_3.
-
Тип колонки:
- 1 для TreeColumn_1;
- 2 для TreeColumn_2;
- 3 для TreeColumn_3.
-
При необходимости можно добавить дополнительные колонки (например, размер файла или время создания). Подробнее см. в разделе Какие данные возвращает компонент.
Как выполнить запрос для получения данных и наполнить дерево
-
Чтобы наполнить дерево данными, добавьте компонент-источник (например, Окружение: браузер файлов) как дочерний элемент для Источника данных дерева.
-
Чтобы данные загружались сразу при открытии формы, настройте обработчик события Opened. Используйте метод, подходящий для типа источника, например, Browse для Окружение: браузер файлов. Пример кода:
Tree_1.TreeDataSource_1.FileSystemBrowser_1.Browse("");
Ручное создание скрипта наполнения дерева
Скрипт для наполнения дерева указывается в обработчике событий. В примерах ниже используется обработчик Opened, который срабатывает при открытии формы.
Как подготовить столбцы
Чтобы подготовить столбцы в компоненте Дерево:
- Добавьте на форму компонент Дерево.
-
Настройте следующие параметры для дерева:
-
Укажите количество столбцов с помощью свойства Число столбцов.
-
Задайте имена столбцов с помощью функции 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 пикселей
-
Как вставить новый элемент
Элементы дерева могут быть корневыми (без родителя) или дочерними (привязанными к родителю).
Чтобы добавить корневой элемент:
-
Объявите переменную для хранения идентификатора элемента (результат функции AddItem).
-
Вызовите функцию AddItem, оставив первый аргумент пустым "".
-
Укажите текст элемента во втором аргументе.
root: var = Tree_1.AddItem("", "Корневой элемент"); // Пустой первый аргумент — без родителя
Как настроить внешний вид элемента дерева
Чтобы настроить внешний вид элемента:
-
Используйте функцию SetItemBackground для установки фона.
-
Используйте SetItemTextColor для изменения цвета текста.
-
Используйте SetItemIcon для установки иконки.
Tree_1.SetItemBackgroundColor(root, 0xffefefef, 0); // Устанавливаем светлый фон
Tree_1.SetItemTextColor(root, 0xff000000, 0); // Устанавливаем черный цвет текста
Tree_1.SetItemIconPath(root, "icon.ico", 0); // Устанавливаем иконку
Как вставить дочерний элемент
Дочерние элементы добавляются к существующим элементам, создавая иерархию.
Чтобы добавить дочерний элемент к существующему:
-
Используйте функцию AddItem, передав в первом аргументе идентификатор родителя, а во втором – текст дочернего элемента.
-
Для вставки элемента в определённое место используйте InsertItem, указав идентификатор родителя, текст элемента и порядковый номер позиции.
child: var = Tree_1.AddItem(root, "Дочерний элемент"); // Добавляем дочерний элемент к корневому элементу root
Tree_1.InsertItem(root, "Элемент в начале", 0); // Вставляем элемент в начало списка дочерних элементов
Как привязать экранную форму к элементу
Чтобы элемент дерева открывал определённую форму, свяжите его с идентификатором формы (UUID). Для этого:
-
Скопируйте идентификатор экранной формы одним из следующих способов:
-
Из свойства Идентификатор:
- Найдите в свойствах формы свойство Идентификатор.
- Скопируйте значение из этого поля.
-
Из файла формы:
- Перейдите в папку проекта objects.
- Найдите файл формы с расширением *.omobj, например, MainForm.omobj.
- Откройте этот файл в текстовом редакторе.
- Скопируйте значение атрибута uuid из первой строки.
-
-
Используйте функцию 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).
Как подготовить столбцы
Чтобы автоматически подготовить столбцы компонента Дерево:
- Добавьте на форму компонент Дерево.
-
Укажите количество столбцов в свойстве Число столбцов компонента Дерево.
- Щёлкните правой кнопкой мыши на элементе Дерево в структуре объекта и выберите команду Создать скрипт наполнения дерева.
-
В строке Путь к дереву укажите путь до компонента Дерево.
-
Настройте параметры столбцов в диалоговом окне:
-
В строке Имя столбца введите нужное имя для каждого столбца.
-
Выберите вид имени в строке Описание:
-
Name – используется имя формы.
-
DisplayName – используется значение свойства формы Отображаемое имя.
-
-
Установите флаги видимости столбцов.
-
- Нажмите кнопку Создать скрипт для генерации кода.
Сгенерированный код будет включать вызовы методов SetColumnName для задания имён столбцов дерева и SetColumnHidden для управления их видимостью.
Как вставить новый элемент
Чтобы добавить элементы в дерево:
-
В окне автоматического создания скрипта выберите формы, которые будут добавлены в список. При этом будет учтена иерархия форм проекта.
- Нажмите кнопку Создать скрипт для генерации кода.
Код будет содержать вызов AddItem с идентификатором родительского элемента и текстом нового элемента. Для корневых элементов родительский идентификатор остаётся пустым (""), а для дочерних указывается идентификатор родителя. Метод SetItemText задаёт текст элемента, отображаемый в дереве.
Как привязать экранную форму к элементу
Чтобы автоматически связать элемент дерева с экранной формой:
-
В окне автоматического создания скрипта в строке Данные выберите GUID.
- Нажмите кнопку Создать скрипт для генерации кода.
Код будет содержать вызов AddItem с идентификатором родительского элемента и текстом нового элемента, а также вызов метода SetItemData, который привязывает уникальный идентификатор (GUID) экранной формы к элементу дерева.
Как отобразить список сигналов источника данных Alpha.Server с помощью древовидного списка (Демо-проект)
Далее кратко описан пример
В примере показано, как:
- Настроить отображение дерева сигналов источника данных в виде древовидной структуры.
- Добавить колонки дерева для отображения информации о структуре узлов.
-
Добавить Браузер источника АР для взаимодействия с источником данных.
- Выполнить запрос для получения данных и наполнить дерево полученными значениями.
В результате будет подготовлена форма, при открытии которой информация о структуре источника будет получена с Alpha.Server и отображена в виде древовидной структуры.
Убедитесь, что у вас уже настроено подключение к источнику данных, с которым вы планируете взаимодействовать. Для получения подробной информации о настройке и подключении источника данных обратитесь к разделу Подключение к источнику.
Настройка отображения сигналов в виде дерева
-
Добавьте на экранную форму объект типа Дерево.
-
В Структуре объектов щелкните правой кнопкой мыши по компоненту Дерево→ Создать.
-
В мастере создания элементов:
-
Оставьте Тип элемента как Экземпляр типа.
-
Выберите Базовый тип элемента→ Источник данных дерева (раздел Визуальные) → нажмите Создать.
-
В результате в структуре объектов появится дочерний компонент — Источник данных дерева.
Добавление колонок дерева
-
В Структуре объектов щелкните правой кнопкой мыши по компоненту Источник данных дерева→ Создать.
-
В мастере создания элементов:
- Оставьте Тип элемента как Экземпляр типа.
- Выберите Базовый тип элемента→ Колонка дерева (раздел Визуальные) → нажмите Создать.
-
В Структуре объектов появится новый дочерний компонент с названием Колонка дерева.
-
Создайте таким образом пять колонок. Они появятся в структуре как TreeColumn_1, TreeColumn_2, TreeColumn_3, TreeColumn_4 и TreeColumn_5.
-
Выберите каждую созданную колонку и настройте для неё следующие свойства:
-
Идентификатор:
- displayName для TreeColumn_1;
- name для TreeColumn_2;
- parentId для TreeColumn_3;
- hasChildren для TreeColumn_4;
- tag для TreeColumn_5.
-
Тип колонки:
- 1 для TreeColumn_1;
- 5 для TreeColumn_2;
- 3 для TreeColumn_3;
- 6 для TreeColumn_4;
- 5 для TreeColumn_5.
-
При необходимости можно добавить дополнительные колонки в зависимости от возвращаемых данных. Подробнее см. в разделе Какие данные возвращает компонент.
Добавление Браузера источника АР
-
Для просмотра дерева сигналов добавьте на форму компонент Браузер источника АР дочерним Источнику данных дерева.
-
В редакторе свойств у объекта Браузер источника АР укажите ссылку на добавленный ранее компонент Источник АР. Для этого нажмите правой кнопкой мыши по свойству Источник АР → Сослаться→ ApSource_1.
Выполнение запроса для получения данных и наполнение дерева
Для загрузки структуры сигналов создайте функцию, которая выполнит запрос и заполнит дерево данными.
- В структуре объекта щелкните правой кнопкой мыши по MainForm и выберите Создать функцию.
- Назовите функцию, например, BrowseNode.
-
В окне Редактор функций:
- Оставьте тип возвращаемого значения как void (функция не будет возвращать данные).
-
Добавьте входные аргументы:
- parentId: string;
- rootPath: string.
-
В поле Тип действия выберите Выполнить код , затем нажмите Редактировать.
-
Введите код:
// Создание запроса для получения структуры сигналов 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); -
Для компонента Дерево добавьте обработчик события ItemExpanded, чтобы при раскрытии узла загружались его дочерние элементы. В обработчике вызовите функцию BrowseNode, передав идентификатор узла (itemId) и значение его тега (tag) из пятой колонки (индекс 4):
BrowseNode(itemId,GetItemText(itemId, 4)); -
Для формы MainForm добавьте обработчик события Opened, чтобы при открытии формы загружались корневые узлы дерева. В обработчике вызовите функцию BrowseNode с пустыми параметрами:
BrowseNode("","");
Как организовать навигацию по экранным формам с помощью древовидного списка (Демо-проект)
Далее кратко описан пример
В примере показано, как:
- Сформировать вручную и отобразить по нажатию кнопки иерархический список экранных форм.
- Настроить открытие связанной экранной формы двойным кликом по элементу списка.
- Добавить всплывающие подсказки, отображаемые при наведении курсора на элементы списка.
- Отобразить изображение в отдельном столбце при клике на него для выбранного элемента списка.
В результате будет подготовлена форма, где по нажатию кнопки появляется иерархический список экранных форм KP (контролируемых пунктов) и SW (задвижек), двойной клик по элементу дерева открывает связанную форму, при наведении курсора на элементы списка показываются подсказки, а клик на изображение добавляет его в отдельный столбец для выбранного элемента списка.
Перед началом работы с примером создайте следующие экранные формы в проекте:
- Контролируемые пункты: KP1, KP2, KP3.
- Задвижки: SW1, SW2, SW3.
Эти формы будут использоваться для привязки к элементам списка.
Создание скрипта для наполнения списка
- Добавьте компонент Дерево на главную форму.
- Добавьте кнопку, которая при нажатии будет выводить список форм.
-
Настройте обработчик события ButtonPressed для кнопки:
-
Укажите количество столбцов 2 с помощью свойства Число столбцов.
-
Установите название первого и второго столбца с помощью функции SetColumnName.
-
Определите 6 переменных (item_0 ... item_5) для хранения id элементов списка.
-
Для элементов item_1, item_2 и item_3 в первом аргументе функции AddItem укажите item_0, чтобы добавить их внутрь КП1.
-
С помощью функции SetItemText задайте имена для каждого элемента.
-
Привяжите экранные формы к элементам списка с помощью функции 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);
-
Открытие формы по двойному клику на элемент списка
- Добавьте на главную форму уведомляющее поле Form_id типа string для хранения id формы.
-
В обработчике события ItemDoubleClicked компонента Дерево присвойте уведомляющему полю значение, полученное из функции GetItemData выбранного элемента.
Form_id = Variant.ToString(GetItemData(itemId, column), "0"); -
В обработчике события ValueChanged для уведомляющего поля Form_id установите тип обработчика Открыть в новом окне и выберите Форма по идентификатору
-
Чтобы при каждом изменении значения уведомляющего поля автоматически открывалась форма с указанным 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);
Добавление изображения в отдельный столбец при клике
- Добавьте на форму компонент Изображение.
- В свойстве Файл изображения нажмите кнопку с тремя точками и выберите файл изображения.
-
В обработчике события MouseClick для компонента Изображение добавьте код, чтобы при клике изображение отображалось в отдельном столбце:
-
Укажите путь к изображению с помощью функции SetImagePath.
-
Сделайте изображение видимым с помощью функции 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);
-