Метод DoCmd.SetFilter (Access)

Используйте метод SetFilter , чтобы применить фильтр к записям в активной таблице, форме, отчете или таблице.

Синтаксис

expression. SetFilter (FilterName, WhereCondition, ControlName)

expression: переменная, представляющая объект DoCmd.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
FilterName	Необязательный	Variant	Если указано, имя запроса или фильтра, сохраненного в качестве запроса. Этот аргумент или аргумент WhereCondition является обязательным.
WhereCondition	Необязательный	Variant	Если это указано, предложение SQL WHERE, которое ограничивает записи в таблице, форме, отчете или таблице.
ControlName	Необязательный	Variant	Если это указано, имя элемента управления, соответствующее подчиненной форме или вложенного отчета для фильтрации. Если он пуст, текущий объект фильтруется.

Замечания

При выполнении этого метода фильтр применяется к таблице, форме, отчету или таблице (например, результату запроса), которые активны и имеют фокус.

Свойство Filter активного объекта используется для сохранения аргумента WhereCondition и его последующего применения. Фильтры сохраняются вместе с объектами, в которых они создаются. Они автоматически загружаются при открытии объекта, но не применяются автоматически.

Чтобы автоматически применить фильтр при открытии объекта, задайте для свойства FilterOnLoad значение True.

Пример

В следующем примере кода активный объект фильтруется таким образом, что он отображает только записи, начинающиеся с "NWTB".

DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.