Метод ДЕРЕВО.ДОБАВИТЬ_УЗЕЛ
Метод добавляет новый узел дерева и позволяет задать некоторые параметры узла.
ФУНКЦИЯ СТРОКА: ДОБАВИТЬ_УЗЕЛ(СТРОКА: родитель, имя;
CТРОКА: текст = "";
ЛОГИКА: развернуть = НЕТ;
ЛОГИКА: опция = НЕТ;
ЦЕЛОЕ: поз = 0)
Параметры
- родитель
- Идентификатор родительского узла, для которого новый узел будет добавлен в конец списка дочерних узлов. Для добавления узла верхнего уровня надо указать пустую строку.
- имя
- Имя нового узла, которое будет использовано для формирования идентификатора узла. Имя не может быть пустой строкой и содержать разделители. Также имя узла не должно повторяться в списке соседних узлов (верхнего уровня или детей одного родителя).
- текст
- Отображаемый текст узла. Если это параметр не указан или задан как пустая строка, то на экране будет отображаться имя узла. Текст узла может быть изменен позже с помощью метода УСТ_ТЕКСТ_УЗЛА.
- развернуть
- Задает начальное состояние развернутости узла. Значение ДА имеет смысл указывать, только когда планируется добавление дочерних узлов. Развернуть или свернуть список дочерних узлов можно позже с помощью метода РАЗВЕРНУТЬ_УЗЕЛ.
- опция
- Задает начальное значение опции узла. Значение ДА можно указывать, только когда поле опции равно ДА. Если поле каскадные_опции равно ДА, то при добавлении дочерних узлов значение опции может переключиться в результате каскадного изменения. Позже значение опции может быть изменено явно с помощью метода УСТ_ОПЦИЮ_УЗЛА или УСТ_СМЕШ_ОПЦИЮ_УЗЛА.
- поз
- Задает позицию вставки узла. Если позиция указана как 0 или больше количества узлов на уровне, то новый узел добавляется в конец списка.
Возвращаемое значение
Метод возвращает идентификатор нового узла. В случае ошибки возвращается пустая строка. Ошибочными считаются следующие ситуации:
- элемент управления не работает в составе показанной формы;
- указанный родительский узел не существует;
- указано недопустимое имя узла;
- указана включенная опция для дерева без поддержки опций.
Дополнительно для узла могут быть указаны такие параметры как:
- всплывающая подсказка – с помощью метода УСТ_ПОДСКАЗКУ_УЗЛА;
- иконка – с помощью метода УСТ_ИКОНКУ_УЗЛА.
Пример
ПЕРЕМ отчеты = дерево.ДОБАВИТЬ_УЗЕЛ("", "отч", "Отчеты", ДА)
ПЕРЕМ обор = дерево.ДОБАВИТЬ_УЗЕЛ(отчеты, "оборотка", "Оборотная ведомость")