Tree.FindByName

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

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

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

Синтаксис

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

Аргументы

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

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

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

Примеры

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 найдена среди всех веток дерева"