<< Click to Display Table of Contents >> Navigation:  Раздел 7 Расширения языка L9 > Объекты пользовательского интерфейса > Объекты для работы с таблицами > Дерево (Tree) > Методы > <Дерево> ПолучитьСписок (GetList)

 

Описание:

Возвращает объект итератора идентификаторов строк, для перебора  в цикле Для Каждого (For Each). При произведении изменений со строками дерева во время обхода по данному итератору будет сгенерирована ошибка "Изменение коллекции во время её обхода".

Синтаксис:

ПолучитьСписок(<Идентификатор>, <Значение>)

GetList(<ID>, <Value>)

Параметры:

Идентификатор (ID) – идентификатор строки. Целое число, которое было получено при вставке строки методом "ВставитьСтроку" ("InsertRow"). Если параметр принимает значение "0" или "Неопределено" ("Undefined"), то возвращается итератор корневых строк. Значение параметра по умолчанию – "Неопределено" ("Undefined"). Параметр не является обязательным.

Значение (Value) – признак рекурсивности. Если параметр принимает значение "Ложь" ("False"), то возвращается итератор дочерних строк первого уровня по отношению к вызываемой строке. Если параметр принимает значение "Истина" ("True"), то возвращается итератор всех дочерних строк по отношению к вызываемой строке.

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

Возвращает объект итератора идентификаторов строк, для перебора  в цикле  "Для Каждого" ("For Each").

Пример:

//В каждой итерации цикла переменной "ДанныеТекущейСтроки" присваиваются

//данные текущей строки. Затем в ячейку с номером "1" заносится
//идентификатор текущей строки. В ячейку "2" заносится идентификатор
//родительской строки (метод "ПолучитьРодительскуюСтроку" ("GetParentRow").
//В текущую строку помещается идентификатор текущей строки из списка,
//который возвращает метод "ПолучитьСписок" ("GetList").
Функция Кнопка_ПриНажатии()
   Для Каждого ТекущаяСтрока Из ЭтаФорма.Дерево.ПолучитьСписок() Цикл
       ДанныеТекущейСтроки = ЭтаФорма.Дерево.ПолучитьДанныеСтроки(ТекущаяСтрока);
       ДанныеТекущейСтроки.УстановитьЗначениеЯчейки(1, Строка(ТекущаяСтрока));
       ДанныеТекущейСтроки.УстановитьЗначениеЯчейки(2, Строка(ЭтаФорма.Дерево.ПолучитьРодительскуюСтроку(ТекущаяСтрока)));
       ЭтаФорма.Дерево.УстановитьДанныеСтроки(ТекущаяСтрока, ДанныеТекущейСтроки);
   КонецЦикла;
   Возврат 0;
КонецФункции