Compartilhar via


Propriedade Report.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 Report .

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.