Объектный тип ДЕРЕВО
Родительские типы: ЭЛЕМЕНТ → ДЕРЕВО.
Физический объектный тип c закрытой моделью.
Тип ДЕРЕВО позволяет заполнить древовидный список узлов. Информация об узлах заполняется после того, как элемент создан в составе содержимого формы. В виде полей задаются лишь самые общие параметры элемента управления.
Элемент ДЕРЕВО может работать в режиме с опциями узлов и без них. При использовании опций узлов элемент может выполнять каскадное включение и выключение опций. Для узлов, имеющих дочерние узлы, возможно состояние частичной включенности опции - смешанное значение. В режиме работы элемента без поддержки каскадного изменения опций управление смешанным состоянием может выполняться вручную.
Один из узлов дерева может быть выделенным.
При добавлении узла задается его имя. Имя узла не отображается пользователю, если задан текст узла. Из имен узлов вдоль ветви дерева составляется идентификатор узла. Имена узлов при формировании идентификатора разделяются точкой или строкой, заданной полем разделитель. Имя узла не может быть пустым или содержать разделители. Идентификатор узла используется в методах для выполнения различных действий с узлами.
Поля
| Тип | Поле | Описание | Значение по умолчанию |
|---|---|---|---|
| БОРДЮР | бордюр | Параметры бордюра вокруг дерева. | |
| СТРОКА | шрифт | Имя шрифта в списке шрифтов формы. | |
| ЛОГИКА | опции | Признак использования опций узлов. | |
| ЛОГИКА | каскадные_опции | Режим каскадного переключения опций узлов. | ДА |
| ЛОГИКА | иконки | Признак отображения иконок узлов. Если это поле имеет значение ДА, то перед текстом всех узлов резервируется место, даже если иконка не задана ни для одного узла. | |
| СТРОКА | разделитель | Разделитель элементов пути в дереве. | "." |
Методы
| Метод | Описание |
|---|---|
| ДОБАВИТЬ_УЗЕЛ | Создает новый узел в дереве. |
| УДАЛИТЬ_УЗЕЛ | Удаляет из дерева указанный узел и все его дочерние узлы. |
| УДАЛИТЬ_ВСЕ | Удаляет из дерева все узлы. |
| ТЕКСТ_УЗЛА | Позволяет получить текст указанного узла. |
| УСТ_ТЕКСТ_УЗЛА | Изменяет текст указанного узла. |
| ПОДСКАЗКА_УЗЛА | Позволяет получить текст всплывающей подсказки для указанного узла. |
| УСТ_ПОДСКАЗКУ_УЗЛА | Позволяет задать текст всплывающей подсказки для указанного узла. |
| ИКОНКА_УЗЛА | Позволяет получить иконку для указанного узла в свернутом или развернутом состоянии. |
| УСТ_ИКОНКУ_УЗЛА | Позволяет задать иконку для указанного узла в свернутом или развернутом состоянии. |
| ПАРАМ_УЗЛА | Позволяет получить дополнительные параметры для указанного узла. |
| УСТ_ПАРАМ_УЗЛА | Позволяет задать дополнительные параметры для указанного узла. |
| ОПЦИЯ_УЗЛА | Позволяет получить текущее значение опции для указанного узла. |
| УСТ_ОПЦИЮ_УЗЛА | Изменяет значение опции для указанного узла и, при каскадном изменении, зависимых от него узлов. |
| СМЕШ_ОПЦИЯ_УЗЛА | Позволяет получить смешанное значение опции для указанного узла. |
| УСТ_СМЕШ_ОПЦИЮ_УЗЛА | Устанавливает смешанное значение опции для указанного узла. |
| УЗЕЛ_РАЗВЕРНУТ | Позволяет проверить, указанный узел развернут. |
| РАЗВЕРНУТЬ_УЗЕЛ | Разворачивает или сворачивает указанный узел. |
| ВЫД_УЗЕЛ | Позволяет получить идентификатор выделенного узла. |
| УСТ_ВЫД_УЗЕЛ | Выделяет указнный узел. |
| КОЛ_УЗЛОВ | Позволяет получить количество дочерних узлов для указанного узла. |
| УЗЕЛ | Позволяет получить идентификатор дочернего узла по его позиции в списке дочерних узлов указанного узла. |
| РОД_УЗЕЛ | Позволяет получить идентификатор родительского узла для указанного узла. |
| СУЩ_УЗЕЛ | Позволяет проверить существование указанного узла. |
| НАЙТИ_УЗЕЛ | Определяет позицию указанного узла среди узлов своего родителя. |
| СЛЕД_УЗЕЛ | Получает следующий узел среди узлов своего родителя. |
| ПРЕД_УЗЕЛ | Получает предыдущий узел среди узлов своего родителя. |
| БЛОК_ОБН | Блокирует обновление дерева на экране или снимает эту блокировку. Может применяться для устанения лишних перерисовок при заполнении видимого на экране дерева. |
Обработчики событий
| Обработчик | Описание |
|---|---|
| клавиша | Вызывается при нажатии пользователем определенных клавиш на клавиатуре. |
| команда | Вызывается при нажатии пользователем функциональных клавиш или выборе пункта контекстного меню. |
| меню | Вызывается вызывается при нажатии пользователем кнопки мыши или клавиши всплывающего меню на клавиатуре. |
| изменение | Вызывается при изменении пользователем выделенного узла дерева. |
| нажатие | Вызывается при двойном клике по иконке или тексту узла или при нажатии клавиши Enter. |
| изменение_опций | Вызывается при переключении какой-либо опции узла с помощью мыши или нажатием клавиши пробел. При каскадном изменении опций обработчик вызывается один раз. |
| разворачивание | Вызывается при разворачивании или сворачивании узла пользователем. |
| перетаскивание | Вызывается при перетаскивании в дерево узла из этого же или другого дерева. |