ВключатьПодчиненные

Установить флаг выборки всех подчиненных элементов.

Синтаксис:

ВключатьПодчиненные(<Режим>]

Англоязычный синоним:

IncludeChildren

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: если 1 — надо включать в выборку все подчиненные элементы, если 0 — не надо включать подчиненные элементы.

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

Текущее числовое значение режима выборки подчиненных элементов спра­вочника (на момент до исполнения метода).

Описание:

Метод ВключатьПодчиненные устанавливает флаг выборки всех подчи­ненных элементов (то есть раскручивания дерева справочника глубже текуще­го уровня).

Данный метод используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника в соответствии с установленным режимом выборки <Режим>. По умолчанию в выборку всегда включаются подчиненные элементы, поэтому реально имеет смысл применять данный метод только в том случае, если надо отменить вклю­чение подчиненных.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

// Это процедура формирования отчета - "Список Товаров"

// ВыбТовар - реквизит диалога типа «справочник.Товар», которым

// задается группа товаров для отображения.

//В процедуру передается параметр Режим, которым задается,

// отображать или нет вложенные подгруппы товаров выбранной группы

Процедура ВыводСпискаТоваров(Режим)

Таб = СоздатьОбъект("Таблица");

Тов = СоздатьОбъект("Справочник.Товары");

Тов.ИспользоватьДату(ДатаОтчета);

Если ВыбТовар.Выбран() = 0 Тогда

//если товар в диалоге не выбран, то формируем отчет без условий

Заг = "По всем товарам.";

ИначеЕсли ВыбТовар.ЭтоГруппа() = 1 Тогда

// если в диалоге выбрана группа товаров, то

// Задаем выборку элементов Справочника из одной группы

Тов.ИспользоватьРодителя(ВыбТовар);

Заг = "По товарам группы " + ВыбТовар.Наименование;

// Задаем выборку всех подчиненных элементов Справочника

Тов.ВключатьПодчиненные(Режим);

Иначе

// если в диалоге выбран товар, то

// формируем отчет только по этому товару

Тов.НайтиЭлемент(ВыбТовар);

Заг = "По товару " + ВыбТовар.Наименование;

Таб.ВывестиСекцию("Отчет");

Таб.ВывестиСекцию("Товар");

Перейти ~MET;

КонецЕсли;

ЧислоСтрок = О;

Таб.ВывестиСекцию("Отчет");

// Открываем выборку

Тов.ВыбратьЭлементы();

Пока Тов.ПолучитьЭлемент() > 0 Цикл

ЧислоСтрок = ЧислоСтрок + 1;

Если Тов.ЭтоГруппа() = 1 Тогда

Таб.ВывестиСекцию("Группа");

Иначе

Таб.ВывестиСекцию("Товар");

КонецЕсли;

Состояние("В отчет выведено " + ЧислоСтрок + " строк.");

КонецЦикла;

//Вызов выходного отчета в окно просмотра и редактирования.

~MET:

Таб.ТолькоПросмотр(1);

Таб.Опции(0, 0, 4, 0);

Таб.Показать("Список товаров по каталогу", "");

КонецПроцедуры

См. также: ВыбратьЭлементы, ПолучитьЭлемент, СоздатьОбъект