|
<< Click to Display Table of Contents >> Navigation: Раздел 7 Расширения языка L9 > Объекты учета > Работа с документами > Документ > Методы > <Документ> УстановитьФильтр (SetFilter) |
Описание:
Устанавливает фильтр по реквизиту документа, возвращает значение "Истина", если фильтр установлен. Если фильтр устанавливается по реквизиту с типом "Строка", то поиск можно осуществлять двумя способами:
• |
по подстроке; |
• |
по точному совпадению строки. |
При установке фильтра смещение, установленное с помощью метода "УстановитьСмещение (SetOffset)", отменяется.
Синтаксис:
УстановитьФильтр(<Ид>, <Значение>)
SetFilter(<Id>, <Value>)
Параметры:
Ид (Id) – строка идентификатора реквизита, по которому устанавливается фильтр.
Значение (Value) – значение или массив значений реквизита, по которому устанавливается фильтр. Если фильтр устанавливается по реквизиту с типом "Строка", то параметр можно указать двумя способами:
• |
перед значением реквизита указываются символы "%%" (два символа процента) – поиск осуществляется по подстроке; |
• |
перед значением реквизита не указываются символы "%%" – поиск осуществляется по точному совпадению строки-значения реквизита. |
Возвращаемые значения:
Возвращает значение "Истина" ("True"), если фильтр установлен, в противном случае возвращает значение "Ложь" ("False").
Пример:
//В примере устанавливается фильтр для документа
// "ДокПродажи" по реквизиту "Клиент"
СпрКлиенты = Новый Справочники.Клиенты;
ДокПродажи = Новый Документы.Продажи;
Клиент = СпрКлиенты.НайтиПоКоду("00000001");
ДокПродажи.СброситьФильтр();
ДокПродажи.УстановитьФильтр("Клиент", Клиент);