Compartilhar via

Propriedade Report.OnApplyFilter (Access)

  • Artigo

Define ou retorna o valor da caixa Aplicar filtro na janela Propriedades de um relatório. String de leitura/gravação.

Sintaxe

expressão. OnApplyFilter

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

Comentários

Essa propriedade é útil para alterar programaticamente a ação que o Microsoft Access toma quando um evento é disparado. Por exemplo, você pode alterar os parâmetros de uma expressão entre chamadas de eventos, ou alternar entre um procedimento de evento e uma expressão ou macro, dependendo das circunstâncias nas quais o evento foi disparado.

O evento ApplyFilter ocorre quando um filtro é aplicado ou removido.

O valor OnApplyFilter será um dos seguintes, dependendo da seleção escolhida na janela Escolher Construtor (acessada escolhendo o botão Compilar ao lado da caixa Em Aplicar Filtro no janela Propriedades do relatório):

  • Se você escolher Construtor de Expressões, o valor será =expression, em que a expressão é a expressão da janela Construtor de Expressões.

  • Se você escolher Construtor de Macros, o valor será o nome da macro.

  • Se você escolher Construtor de Código, o valor será [Procedimento de Evento].

Se a caixa Ao aplicar filtro estiver em branco, o valor da propriedade será uma sequência de caracteres vazia.

Exemplo

O exemplo a seguir associa a propriedade OnApplyFilter para o relatório Catalog ao evento Report_ApplyFilter.

Reports("Catalog").OnApplyFilter = "[Event Procedure]"

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.