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

Методы контекста Модуля формы журнала расчетов

УстановитьОтбор

Установить выборку по графе отбора.

Синтаксис:

УстановитьОтбор(<ИмяГрафыОтбора>, <ЗначениеОтбора>)

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

SetSelection

Параметры:

<ИмяГрафыОтбора> Строковое значение. Наименование графы отбора, как она определена при конфигурировании.
<ЗначениеОтбора> Отбираемое значение.

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

Число: 1 – если отбор успешно установлен; 0 – в противном случае.

Описание:

Метод предназначен для выборки записей журнала расчетов, которые содержат в графе отбора <ИмяГрафыОтбора> заданное <ЗначениеОтбора>. Если первый параметр задан неверно – т. е. нет такой графы отбора, выборка не будет выполнена и метод возвратит 0. Если заданное <ЗначениеОтбора> не будет найдено ни в одной строке журнала расчетов, выборка окажется пустой (т. е. в нее не попадет ни одна запись журнала расчетов), но метод возвратит значение 1.

Если метод сработал, т. е. выборка реально установлена, происходит перерисовка окна журнала расчетов так же, как это происходит при интерактивном выполнении операции отбора.

Для отказа от отбора по значению необходимо вызвать данный метод, указав в качестве первого параметра пустую строку.

Замечание
Наименованиями граф отбора журнала расчетов могут служить реквизиты справочника объектов расчета, заданного для журнала расчетов, а также значения "Владелец" и "Родитель" этого справочника. Это значит, что в общем случае, в качестве первого параметра, методу могут передаваться предопределенные имена "Родитель" и "Владелец", а также названия реквизитов справочника
.

Какие именно графы отбора задействованы в журнале расчетов, задается при конфигурировании.

Данный метод доступен только в контексте Модуля формы журнала расчетов (см. "Виды программных модулей").

Пример:

// модуль формы журнала расчетов

// процедура снимает отбор

Процедура ВыбратьВсе();

УстановитьОтбор("");

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

// Установим отбор сразу при открытии журнала расчетов Зарплата

// Расчетчик — глобальная переменная со ссылкой на группу

// сотрудников

УстановитьОтбор("Родитель", Расчетчик);

См. также: ПолучитьОтбор, ЗакладкиОтбора.

Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.