Propriedade Form.Filter (Access)

Utilize a propriedade Filtro para especificar um subconjunto de registos a apresentar 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 seguinte código do Visual Basic define e aplica um filtro para mostrar apenas clientes dos EUA.

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

Utilize a propriedade Filtro para guardar um filtro 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 automaticamente aplicados.

Quando um novo objeto é criado, herda as propriedades OrigemDosRegistos, Filtro, OrdenarPor e OrdenarPorLigado da tabela ou consulta a partir da qual foi criado.

Para aplicar um filtro guardado a um formulário, consulta ou tabela, pode escolher Aplicar Filtro na barra de ferramentas, selecionar Aplicar Filtro/Ordenar no menu Registos ou utilizar uma macro ou Visual Basic para definir a propriedade FilterOn como Verdadeiro. 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.

Pode remover um filtro ao selecionar o botão Aplicar Filtro premido, selecionar Remover Filtro/Ordenar no menu Registos ou utilizar o Visual Basic para definir a propriedade FilterOn como Falso.

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.