Evento Report.Filter (Access)
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.