Compartilhar via

Evento Report.Filter (Access)

  • Artigo

Ocorre quando o usuário abre uma janela de filtro escolhendo Filtro/Classificação Avançada.

Sintaxe

expressão. Filtro (Cancelar, FilterType)

Expressão Uma variável que representa um objeto Report .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Cancel Obrigatório Integer A configuração determina se deve abrir a janela de filtro. Definir o argumento Cancelar como True (1) impede a abertura da janela de filtro. Você também pode usar o método CancelEvent do objeto DoCmd para cancelar a abertura da janela de filtro.
FilterType Obrigatório Integer A janela Filtro que o usuário está tentando abrir. O argumento FilterType pode ser acFilterAdvanced.

Comentários

Para executar um macro ou procedimento de evento quando esse evento ocorrer, defina a propriedade OnFilter como o nome da macro ou como [procedimento do evento].

Use o evento Filter para:

  • Remova qualquer filtro anterior para o relatório. Para fazer isso, defina a propriedade Filter ou a propriedade ServerFilter do relatório para uma cadeia de caracteres de comprimento zero ("") em que o filtro de macro ou procedimento de evento. Isso é especialmente útil se você quiser garantir que critérios desnecessários não apareçam no novo filtro. Por exemplo, quando você usa o recurso Filtrar por Seleção , os critérios usados (o texto selecionado no relatório) são adicionados à expressão de cláusula WHERE da propriedade Filter ou ServerFilter e são exibidos na janela Filtro/Classificação Avançada . Você pode remover esses critérios antigos usando o evento Filter.

  • Insira as configurações padrão para o novo filtro. Para fazer isso, defina a propriedade Filter ou ServerFilter propriedade para incluir esses critérios. Por exemplo, você pode querer que todos os filtros de um relatório products exibam apenas produtos atuais (produtos para os quais o controle descontinuado no relatório Produtos não está selecionado).

  • Use seu próprio janela Filtro personalizado em vez de uma das janelas de filtro do Microsoft Access. Quando o evento Filter ocorre, você pode abrir o seu próprio formulário personalizado e utilizar as entradas este relatório para definir a propriedade Filter ou a propriedade ServerFilter e filtrar o relatório original. Quando o usuário fechar esse formulário personalizado, defina a propriedade FilterOn ou a propriedade ServerFilterByForm do relatório original como True (1) para aplicar o filtro. Cancelar o evento Filtrar impede a abertura da janela filtro de acesso.

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.