Propriedade Form.Filter (Access)

Use a propriedade Filter para especificar um subconjunto de registros a serem exibidos quando um filtro é aplicado a um formulário, relatório, consulta ou tabela. String de leitura/gravação.

Sintaxe

expressão.Filtro

expressão Uma variável que representa um objeto Form.

Comentários

Se você deseja especificar um filtro do servidor em um projeto do Microsoft Access (. adp) para dados localizados em um servidor, use a propriedade ServerFilter.

A propriedade Filter é uma expressão de cadeia de caracteres que consiste em uma cláusula WHERE sem a palavra-chave WHERE. Por exemplo, o código do Visual Basic a seguir define e aplica um filtro para mostrar apenas clientes dos EUA.

Me.Filter = "Country = 'USA'" 
Me.FilterOn = True

Observação

Definir a propriedade Filter não tem efeito na propriedade Filtro do ADO.

Use a propriedade Filter para salvar um filtro 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 automaticamente aplicados.

Quando um novo objeto é criado, ele herda as propriedades RecordSource, Filter, OrderBy e OrderByOn da tabela ou consulta da qual foi criado.

Para aplicar um filtro salvo a um formulário, consulta ou tabela, você pode escolher Aplicar Filtro na barra de ferramentas, escolher Aplicar Filtro/Classificar no menu Registros ou usar uma macro ou Visual Basic para definir a propriedade FilterOn como True. Para relatórios, você pode aplicar um filtro definindo a propriedade FilterOn como Sim na folha de propriedades do relatório.

O botão Aplicar filtro indica o estado das propriedades Filter e FilterOn. O botão permanece desativado até que haja um filtro a ser aplicado. Se um filtro existente é aplicado no momento, o botão Aplicar filtro aparece pressionado.

Para aplicar um filtro automaticamente quando um formulário é aberto, especifique na configuração da propriedade de evento OnOpen do formulário uma macro que use a ação AplicarFiltro ou um procedimento de evento que utiliza o método ApplyFilter do objeto DoCmd.

Você pode remover um filtro escolhendo o botão Aplicar Filtro pressionado, escolhendo Remover Filtro/Classificar no menu Registros ou usando o Visual Basic para definir a propriedade FilterOn como False.

Quando a propriedade Filter é definida no modo Design do formulário, o Microsoft Access não tenta validar a expressão SQL. Se a expressão SQL for inválida, ocorrerá um erro quando o filtro for aplicado.

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.