DoCmd.SetFilter (Access)

Use o método SetFilter para aplicar um filtro aos registros na folha de dados ativa, formulário, relatório ou tabela.

Quando você executa esse método, o filtro é aplicado à tabela, ao formulário, ao relatório ou à folha de dados (por exemplo, o resultado da consulta) que está ativa e tem o foco. A propriedade Filter do objeto ativo é usada para salvar o argumento WhereCondition e aplicá-lo mais tarde. Filtros são salvos com os objetos nos quais eles são criados. Eles são carregados automaticamente quando o objeto é aberto, mas não são aplicadas automaticamente. Para aplicar automaticamente um filtro quando o objeto é aberto, defina a propriedade FilterOnLoad como true.

SetFilter (FilterName, WhereCondition, ControlName)

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

Arguments

Optional arguments

Os seguintes argumentos são opcionais

FilterName (String) - Se for fornecido, o nome de uma consulta ou de um filtro salvo como consulta. Este argumento ou o argumento WhereCondition é obrigatório.

WhereCondition (String) - Se for fornecido, uma cláusula SQL WHERE que restringe os registros na folha de dados, formulário, relatório ou tabela.

ControlName (String) - Se for fornecido, o nome do controle que corresponde ao subformulário ou ao subrelatório a ser filtrado. Se estiver em branco, o objeto atual será filtrado.