Propriedade Report.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 Relatório .

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.