Tree.FindByName

FindByName (Функции поиска)
Объект: Дерево Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, число Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Дерево

Применимо к объектам ветки и дерева. Функция производит поиск указанной строки среди наименований дочерних веток текущего объекта (с возможностью поиска во вложенных ветках). Если ветка найдена, функция возвращает ее в виде объекта, иначе возвращается пустое значение. Поиск осуществляется без учета регистра.

Синтаксис

Tree.FindByName(<Наименование ветки для поиска (STRING)>,<Включать дочерние ветки в поиск (INT)>=0):<Найденная ветка (BRANCH)>

Аргументы

• <Наименование ветки для поиска (STRING)> - Наименование ветки, которую необходимо найти
• <Включать дочерние ветки в поиск (INT)> - (необязательный аргумент) Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта.

Возвращаемое значение

Возвращает первую найденную ветку, которая имеет указанное наименование, либо пустое значение, если ветка не найдена.

Примеры

aTree:=Tree.Create();
aBranch1:=aTree.Add(1,"Ветка 1");
aBranch1.Add(2,"Ветка 1.1");
aTree.Add(3,"Ветка 2");
aTree.Insert(1,0,"Ветка 0");

Message("Ветка с наименованием Ветка 1.1 "+?(isEmpty(aTree.Find(2)),"не ")+"найдена среди верхних веток дерева");
Message("Ветка с наименованием Ветка 1.1 "+?(isEmpty(aTree.Find(2,1)),"не ")+"найдена среди всех веток дерева");
//Пример выведет:
//"Ветка с наименованием Ветка 1.1 не найдена среди верхних веток дерева"
//"Ветка с наименованием Ветка 1.1 найдена среди всех веток дерева"