Ação da macro DefinirFiltro

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação DefinirFiltro para aplicar um filtro aos registros na folha de dados, formulário, relatório ou tabela ativa.

Setting

A ação DefinirFiltro tem os seguintes argumentos.

Argumento da ação	Descrição
Nome do Filtro	Se for fornecido, o nome de uma consulta ou de um filtro que foi salvo como uma consulta. Esse argumento ou o argumento CondiçãoWhere são obrigatórios em um banco de dados cliente. Em um banco de dados Web, esse argumento não está disponível.
Condição Where	Se for fornecido, uma cláusula SQL WHERE que restringe os registros na folha de dados, formulário, relatório ou tabela. Em um banco de dados Web, esse argumento é necessário.
Nome do controle	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

Em um banco de dados da Web, o argumento Condição Where não pode começar por um sinal de igualdade (=).

Quando você executar essa ação, o filtro será aplicado à tabela, ao formulário, ao relatório ou à folha de dados (por exemplo, resultado da pesquisa) que está ativa e que tem o foco.

A propriedade Filtro do objeto ativo é usada para salvar o argumento CondiçãoWhere e aplicá-lo posteriormente. Filtros são salvos com os objetos nos quais eles são criados. Eles são automaticamente carregados quando o objeto é aberto, mas não são automaticamente aplicados.

Em um banco de dados cliente, para aplicar um filtro automaticamente quando o objeto é aberto, defina a propriedade como FiltrarNoCarregamento com o valor True.

Em um banco de dados da Web, para aplicar um filtro automaticamente quando o objeto é aberto, adicione a ação DefinirFiltro a uma macro e adicione a macro ao evento OnLoad do objeto.

Exemplo

O exemplo a seguir mostra como usar a ação SetFilter para filtrar o formulário no qual a macro é definida.

Código de exemplo fornecido por: a Referência do programador do Microsoft Access 2010.

    OpenForm
        Form Name sfrmFoods
        View Form
        Filter Name
        Where Condition
        Data Mode
        Window Mode Normal
    
    SetFilter
        Filter Name
        Where Condition =[display_name] Like "*cheese*"
        Control Name