Compartilhar via


Método Event.GetFilterCommands (Visio)

Retorna uma série de intervalos de comandos e um valor True ou False indicando como filtrar eventos para aquele intervalo de comando.

Sintaxe

expression. GetFilterCommands

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

Valor de retorno

Long()

Comentários

Os filtros de evento descritos na série retornados pelo método GetFilterCommands fornecem aos desenvolvedores uma maneira de ignorar eventos especificados com base em uma ID de comando. A série retornada é aquela passada ao método SetFilterCommands para esse objeto Event.

A série retornada pelo método GetFilterCommands pode ser interpretada da seguinte maneira:

O número de elementos na série é um múltiplo de 3, como se segue:

  • O primeiro elemento contém a ID de comando inicial do intervalo (qualquer membro do VisUICmds).

  • O segundo elemento contém a ID final de comando do intervalo (qualquer membro de VisUICmds).

  • O terceiro elemento contém um valor True ou False, que indica se você está escutando eventos desse intervalo de comando (True para escutar a eventos; False para excluir eventos).

Para um evento passar com êxito por um filtro de comando, ele deve satisfazer os seguintes critérios:

  • Deve ter uma ID de comando válida.

  • Se todos os filtros forem True, o evento deverá corresponder a pelo menos um filtro.

  • Se todos os filtros forem False, o evento não deverá corresponder a nenhum filtro.

  • Se os filtros forem uma mistura de True e False, o evento deverá corresponder a pelo menos um filtro True e não deverá corresponder a nenhum filtro False.

Se não existirem intervalos True definidos na série, os eventos serão considerados True.

Para obter detalhes sobre como usar as IDs de comando para definir filtros de evento, consulte o método SetFilterCommands.

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.