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
mais simples. 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 de pedidos inclui critérios que restringem o campo DatadoPedido . Para fazer isso, marque o valor da propriedade Filter ou ServerFilter do relatório para garantir que esse critério seja incluído 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.
Desfaça ou altere as ações executadas quando o evento Filter ocorreu. Por exemplo, você pode desabilitar ou ocultar alguns controles no relatório quando o usuário está 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 na macro ou no procedimento de evento ApplyFilter ocorrem antes da aplicação ou remoção do filtro ou depois que a janela Filtrar/Classificar Avançado é fechada, mas antes de o relatório ser exibido novamente. Os critérios que você inseriu 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 Close ou o método Close do objeto DoCmd para fechar a janela Filtrar/Classificar Avançado.
Define a propriedade Filter ou ServerFilter ou a propriedade FilterOn em uma macro ou Visual Basic (embora você possa definir essas propriedades em um procedimento de evento ApplyFilter ou macro).
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.