Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Ocorre quando um filtro é aplicado a um relatório.
Sintaxe
expressão. ApplyFilter (Cancelar, ApplyType)
expressão Uma variável que representa um objeto Relatório .
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].
Utilize o evento ApplyFilter para:
Certifique-se de que o filtro que está a ser aplicado está correto. Por exemplo, pode querer ter a certeza de que qualquer filtro aplicado a um relatório Encomendas inclui critérios que restringem o campo DataDaEncomenda . Para tal, marcar o valor da propriedade Filtro ou ServerFilter do relatório para garantir que estes 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.
Anule ou altere as ações que efetuou quando ocorreu o evento Filtrar . Por exemplo, pode desativar ou ocultar alguns controlos no relatório quando o utilizador estiver a criar o filtro porque não quer que estes controlos 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 de o filtro ser aplicado ou removido ou após a janela Filtro/Ordenação Avançada ser fechada, mas antes de o relatório ser reproduzido. Os critérios que introduziu no filtro recentemente criado estão disponíveis para o procedimento de evento Ou macro AplicarFiltro como a definição da propriedade Filtro ou FiltroDoServidor .
O evento ApplyFilter não ocorrerá quando o usuário um destes procedimentos:
Aplica ou remove um filtro com as ações AplicarFiltro, OpenReport ou ShowAllRecords numa macro ou os métodos correspondentes do objeto DoCmd no Visual Basic.
Utiliza a ação Fechar ou o método Fechar do objeto DoCmd para fechar a janela Filtro Avançado/Ordenação.
Define a propriedade Filter ou ServerFilter ou a propriedade FilterOn numa macro ou Visual Basic (embora possa definir estas propriedades numa macro ou procedimento de evento AplicarFiltro ).
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.