Evento Report.ApplyFilter (Access)

Ocorre quando um filtro é aplicado a um relatório.

Sintaxe

expressão. ApplyFilter (Cancelar, ApplyType)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Cancel	Obrigatório	Inteiro	A configuração determina se o evento ApplyFilter ocorre. A definição do argumento de Cancel como True cancela o evento ApplyFilter e o filtro não será aplicado ao relatório.
ApplyType	Obrigatório	Número inteiro	Retorna o tipo de filtro que foi aplicado.

Comentários

Para executar uma macro ou um procedimento de evento quando ele ocorrer, defina a propriedade OnApplyFilter como o nome da macro ou como [Procedimento do Evento].

Use o evento ApplyFilter para:

• Verifique se o filtro que está sendo aplicado está correto. Por exemplo, talvez você queira ter certeza de que qualquer filtro aplicado a um relatório orders inclui critérios que restringem o campo OrderDate . Para fazer isso, verifique o valor da propriedade Filter ou ServerFilter do relatório para verificar se esses critérios estão incluídos na expressão da cláusula WHERE.

• Alterar a exibição do relatório antes de aplicar o filtro. Por exemplo, quando você aplicar um determinado filtro, pode querer desativar ou ocultar alguns campos que não sejam apropriados para os registros exibidos por esse filtro.

• Desfazer ou alterar as ações que você tomou quando o evento Filter ocorreu. Por exemplo, você pode desabilitar ou ocultar alguns controles no relatório quando o usuário estiver criando o filtro porque não deseja que esses controles sejam incluídos nos critérios de filtro. Depois, ative ou exiba esses controles depois que o filtro for aplicado.

As ações no procedimento ou macro do evento ApplyFilter ocorrem antes que o filtro seja aplicado ou removido, ou depois que a janela Filtro/Classificação Avançada for fechada, mas antes que o relatório seja redisplay. Os critérios inseridos no filtro recém-criado estão disponíveis para o procedimento de evento ApplyFilter ou macro como a configuração da propriedade Filter ou ServerFilter .

O evento ApplyFilter não ocorrerá quando o usuário um destes procedimentos:

• Aplica ou remove um filtro usando as ações ApplyFilter, OpenReport ou ShowAllRecords em uma macro ou seus métodos correspondentes do objeto DoCmd no Visual Basic.

• Usa a ação Fechar ou o método Fechar do objeto DoCmd para fechar a janela Filtro/Classificação Avançada.

• Define a propriedade Filter ou ServerFilter ou FilterOn em uma macro ou Visual Basic (embora você possa definir essas propriedades em um procedimento ou macro de evento ApplyFilter ).

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.