Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы справочников

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

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

Синтаксис:

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

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

IncludeChildren

Параметры:

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

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

Описание:

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

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Иначе

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

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

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

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

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

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

Перейти ~MET;

КонецЕсли;

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

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

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

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

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

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

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

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

Иначе

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

КонецЕсли;

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

КонецЦикла;

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

~MET:

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

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

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

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

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