ВключатьПодчиненные
Установить флаг выборки всех подчиненных элементов.
Синтаксис:
ВключатьПодчиненные(<Режим>]
Англоязычный синоним:
IncludeChildren
Параметры:
|
<Режим> |
Необязательный параметр. Числовое выражение: если 1 — надо включать в выборку все подчиненные элементы, если 0 — не надо включать подчиненные элементы. |
Возвращаемое значение:
Текущее числовое значение режима выборки подчиненных элементов справочника (на момент до исполнения метода).
Описание:
Метод ВключатьПодчиненные устанавливает флаг выборки всех подчиненных элементов (то есть раскручивания дерева справочника глубже текущего уровня).
Данный метод используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника в соответствии с установленным режимом выборки <Режим>. По умолчанию в выборку всегда включаются подчиненные элементы, поэтому реально имеет смысл применять данный метод только в том случае, если надо отменить включение подчиненных.
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
// Это процедура формирования отчета - "Список Товаров"
// ВыбТовар - реквизит диалога типа «справочник.Товар», которым
// задается группа товаров для отображения.
//В процедуру передается параметр Режим, которым задается,
// отображать или нет вложенные подгруппы товаров выбранной группы
Процедура ВыводСпискаТоваров(Режим)
Таб = СоздатьОбъект("Таблица");
Тов = СоздатьОбъект("Справочник.Товары");
Тов.ИспользоватьДату(ДатаОтчета);
Если ВыбТовар.Выбран() = 0 Тогда
//если товар в диалоге не выбран, то формируем отчет без условий
Заг = "По всем товарам.";
ИначеЕсли ВыбТовар.ЭтоГруппа() = 1 Тогда
// если в диалоге выбрана группа товаров, то
// Задаем выборку элементов Справочника из одной группы
Тов.ИспользоватьРодителя(ВыбТовар);
