Método 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.
Sintaxe
expressão. SetFilter (FilterName, WhereCondition, ControlName)
expression Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| FilterName | Opcional | Variant | Se for fornecido, o nome de uma consulta ou de um filtro salvo como consulta. Esse argumento ou o argumento WhereCondition é necessário. |
| WhereCondition | Opcional | Variant | Se for fornecido, uma cláusula SQL WHERE que restringe os registros na folha de dados, formulário, relatório ou tabela. |
| Controlname | Opcional | Variant | 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. |
Comentários
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 posteriormente. 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 for aberto, defina a propriedade FilterOnLoad como True.
Exemplo
O exemplo de código a seguir filtra o objeto ativo para que exiba somente os registros que começam com "NWTB".
DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.