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