Дерево одиночного/множественного выбора

<< Click to Display Table of Contents >>

Navigation:  Создание окон для клиента визуализации > Библиотека HMI > Категория Контролы >

Дерево одиночного/множественного выбора

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

В палитре редактора HMI элемент Дерево одиночного выбора находится в категории Контролы.

Вид элементов в палитре:

Дерево одиночного выбора

Дерево множественного выбора

Вид элементов после добавления в рабочую область редактора HMI:

Какие данные будут отображаться в деревьях зависит от настроек элемента.

Вид панели свойств:

Дерево одиночного выбора

Дерево множественного выбора

Описание основных свойств графического элемента Дерево одиночного выбора:

Название

Назначение

Категория Текст

Таблица стилей

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

Используется только для динамизации полей Дерева одиночного выбора.

Категория Параметры

Источник данных

Определяет содержимое дерева. Нужно или задать константу, или связать с параметром типа STRING. Задается разработчиком проекта только в том случае, если свойство Тип источника имеет значение Custom. Представляет собой строку JSON. Порядок формирования строки JSON смотрите в разделе Источник данных для дерева одиночного/множественного выбора

Тип источника

Определяет способ формирования источника данных. Возможные варианты:

ProjectTree — отображаются полное дерево проекта с параметрами, объектами, группами;

ObjectsTree — отображаются дерево объектов с объектами и папками;

Custom — отображаются данные поступающие на свойство Источник данных;

ObjectWindowTree — отображаются окна, объекты и папки;

WindowTree — отображаются окна и папки.

Если у объекта задано Главное окно — при клике открывается именно оно. Если Главное окно объекта не задано — при клике открывается:

Стартовое окно (если оно назначено для объекта);

Если стартового окна нет — первое окно объекта в алфавитном порядке.

Раскрытый

Флаг определяет, в каком состоянии будет дерево. Если флаг установлен, то дерево будет раскрыто.

Идентификатор поля

Поле влияет на то, какое значение будет выводить в свойствах Значение (для Дерева одиночного выбора) и Значения (для Дерева множественного выбора). По умолчанию установлено значение ID - в этом случае будет указаны ID элементов выделенных в дереве. Менять можно только для типа источника Custom, т.е. можно указать имя атрибута JSON, в котором записан идентификатор узла.

Название поля

Имя атрибута JSON, в котором записано отображаемое имя для узла дерева.

Изменение по методу

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

Идентификатор корневого узла

Определяет, что будет отображаться только указанный данный объект и его элементы дочерние.

Значение/Значения

Показывает выделенные поля в дереве. Тип информации выдаваемой в данном свойстве зависит от значения свойства Идентификатор поля.

Идентификатор поля наследников

Определяет символ, которым будет определяться дочерние элементы.

Уровень вложенности

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

0 — значение по умолчанию. Обеспечивает полное раскрытие дерева с отображением всех элементов независимо от уровня вложенности.

1 — отображаются только элементы первого уровня (корневые категории). К таким категориям относятся, например: Система, Узел, Архивы, Безопасность, Объекты и другие элементы верхнего уровня структуры проекта.

Тип значения

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

Идентификатор - будет выводиться ID элемента, выделенного в дереве.

Путь - будет выводиться путь до элемента, выделенного в дереве.

Сохранять состояние

Позволяет сохранять состояние дерева выбора при переходе в другие окна. По умолчанию FALSE.

Тип отображаемого имени

Позволяет использовать разные названия для одного элемента. В свойствах элемента проекта Описание необходимо ввести имя. В свойстве Тип отображаемого имени выбрать Описание. В дереве будут отображаться названия из поля Описание элементов проекта.

Возможные варианты:

Имя — используется основное имя элемента проекта;

Описание — используется текст из свойства Описание элемента.

Категория Внешний вид

 

Стиль дерева

Определяет общий стиль отображения элементов:

Дерево;

Кнопки — элементы отображаются в виде кнопок.

По умолчанию: Дерево.

Глубина отступа вложенности

Задает ширину отступа (в пикселях) для каждого уровня вложенности в дереве. По умолчанию: 29.

Вертикальный интервал между элементами

Определяет расстояние по вертикали (в пикселях) между соседними элементами. По умолчанию: 0.

Высота элемента

Задает фиксированную высоту строки элемента в пикселях. Если установлено 0, высота рассчитывается автоматически на основе размера шрифта. По умолчанию: 0.

Цвет выделенного элемента

Определяет цвет фона активного (выбранного) элемента. Выбор цвета из палитры. Приоритет у Стиля темы выше, чем у Настройки контрола.

Толщина рамки выделенного элемента

Задает толщину (в пикселях) рамки вокруг активного элемента. По умолчанию: 0.

Цвет рамки выделенного элемента

Определяет цвет рамки активного элемента. Выбор цвета из палитры.

Стиль рамки выделенного элемента

Определяет тип линии для рамки активного элемента:

Непрерывный;

Пунктир;

Точка;

Нет.

По умолчанию: Непрерывный.

Категория Разрешения

 

Отображать в контролах навигации

Позволяет управлять видимостью элементов проекта. Возможные варианты:

Отображать — элемент и все его дочерние элементы видны в дереве навигации;

Не отображать — элемент и все его дочерние элементы скрыты из дерева навигации;

Отображать только дочерние — сам элемент скрывается из дерева, но все его дочерние элементы остаются видимыми, при этом их иерархия сохраняется, а они сами отображаются на уровень выше.

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

Название

Назначение

Заливка фона активного флага

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

Прозрачность флага

Задает степень прозрачности флага. Значение изменяется в пределах от 0 до 100, где 0 - элемент полностью прозрачный, 100 - элемент полностью не прозрачный. Если элемент полностью прозрачный, то динамизация и Действия не исполняются.

Размер тени флага

Определяет величину тени флага (тень элемента появляется снизу и справа).

Цвет тени флага

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

Вид курсора флага

Определяет вид курсора при наведении мыши на флаг в клиенте визуализации:

Радиус скругления флага

Задает радиус скругления углов рамки флага (в px).

Цвет индикатора флага

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

Толщина рамки флага

Определяет толщину рамки флага.

Цвет рамки флага

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

Стиль рамки флага

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

Описание других свойств элемента смотрите в разделе HMI.Свойства

Смотрите также: