Раздел 7 Расширения языка L9 > Объекты учета > Работа со справочниками > Справочник > Методы > <Справочник> УстановитьФильтр (SetFilter)

Описание:

Устанавливает фильтр по реквизиту справочника, возвращает значение "Истина", если фильтр установлен. Если фильтр устанавливается по реквизиту с типом "Строка", то поиск можно осуществлять двумя способами:

•	по подстроке;

•	по точному совпадению строки.

При установке фильтра смещение, установленное с помощью метода "УстановитьСмещение (SetOffset)", отменяется.

Синтаксис:

УстановитьФильтр(<Ид>, <Значение>)

SetFilter(<Id>, <Value>)

Параметры:

Ид (Id) – строка идентификатора реквизита, по которому устанавливается фильтр.

Значение (Value) – значение или массив значений реквизита, по которым устанавливается фильтр. Если фильтр устанавливается по реквизиту с типом "Строка", то параметр можно указать двумя способами:

•	перед значением реквизита указываются символы "%%" (два символа процента) – поиск осуществляется по подстроке;

•	перед значением реквизита не указываются символы "%%" – поиск осуществляется по точному совпадению строки-значения реквизита.

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

Возвращает значение "Истина" ("True"), если фильтр установлен, в противном случае возвращает значение "Ложь" ("False").

Пример:

//В примере устанавливается фильтр в справочнике "СпрНоменклатура" по реквизиту "Наименование"

СтрЗначение = ЭтаФорма.ПолеПоиска.Текст;
СпрНоменклатура.УстановитьФильтр("Наименование", СтрЗначение);