Aplicável a
Objeto Form |
Objeto Report |
É possível usar a propriedade Filter para especificar um subconjunto dos registros a serem exibidos quando um filtro é aplicado a um formulário, relatórioconsulta ou tabela. Cadeia de caracteres de leitura/gravação.
expressão.Filter
expressão Obrigatória. Uma expressão que retorna um dos objetos na lista Aplica-se a.
Comentários
Se você quiser especificar um filtro de servidor em um projeto do Microsoft Access (.adp) para os dados localizados em um servidor, use a propriedade ServerFilter.
A propriedade Filter é uma expressão de cadeia de caracteres formada por uma cláusula WHERE sem a palavra-chave WHERE. Por exemplo, o seguinte código do VBA (Visual Basic for Applications) define e aplica um filtro para mostrar apenas clientes dos EUA:
Me.Filter = "CountryRegion = 'USA'"
Me.FilterOn = True
É possível definir essa propriedade usando a folha de propriedades da tabela ou do formulário, uma macro ou o código do VBA.
Você também pode defini-la nos modos de exibição Formulário, Relatório, Folha de Dados ou Layout clicando em Filtrar ou em Seleção em Classificar e Filtrar na guia Dados e clicando em um dos comandos no submenu.
Observação: A configuração da propriedade Filter não tem efeito sobre a propriedade Filter do ADO.
Você pode usar a propriedade Filter para salvar um filtro e aplicá-lo mais tarde. Os filtros são salvos com os objetos em que são criados. Eles são carregados automaticamente quando o objeto é aberto, mas não são aplicados automaticamente.
Quando um novo objeto for criado, ele herdará as propriedades RecordSource , Filter, OrderBy e OrderByOn da tabela ou consulta a partir da qual ele foi criado.
Para aplicar um filtro salvo a um formulário, consulta ou tabela, clique em Alternar Filtro em Classificar e Filtrar na guia Dados ou use uma macro ou código do VBA para definir a propriedade FilterOn para Verdadeiro. Em relatórios, é possível aplicar um filtro definindo a propriedade FilterOn como Yes na folha de propriedades do relatório.
O botão Alternar Filtro indica o estado das propriedades Filter e FilterOn. O botão permanece desabilitado até que um filtro seja aplicado. Quando há um filtro aplicado, o botão Alternar Filtro aparece pressionado.
Para aplicar um filtro automaticamente quando um formulário estiver aberto, especifique na configuração de propriedade do evento OnOpen do formulário uma macro que usa a ação ApplyFilter ou um procedimento de evento que usa o método ApplyFilter do objetoDoCmd.
Para remover um filtro, clique no botão pressionado Alternar Filtro, clique com o botão direito do mouse no campo filtrado e clique em Limpar filtro de... ou use o código do VBA para definir a propriedade FilterOn como Falso.