Compartir por

Método Event.SetFilterCommands (Visio)

Especifica una matriz de intervalos de comandos y un valor True o False que indica cómo se van a filtrar los eventos de cada intervalo de comandos.

Sintaxis

expresión. SetFilterCommands( _Commands()_ )

Expresión Variable que representa un objeto Event .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Commands() Necesario Long Matriz de intervalos de comandos y un valor True o False que indica cómo se van a filtrar los eventos de cada intervalo.

Valor devuelto

Nothing

Comentarios

Cuando un objeto Event creado con el método AddAdvise se agrega a la colección EventList de un objeto de origen, el comportamiento predeterminado es que todas las repeticiones de ese evento se pasen al receptor del evento. El método SetFilterCommands proporciona una manera de omitir eventos seleccionados según el identificador del comando.

El parámetro Commands() que se pasa a SetFilterCommands es una matriz definida de la manera siguiente:

El número de elementos de Commands() es un múltiplo de 3:

  • El primer elemento contiene el identificador de comando inicial del intervalo (cualquier miembro de VisUICmds).

  • El segundo elemento contiene el identificador de comando final del intervalo (cualquier miembro de VisUICmds).

  • El tercer elemento contiene un valor True o False, que indica si se escuchan los eventos de ese intervalo de comandos (True para escuchar los eventos; False para excluir los eventos).

Para que un evento pase correctamente un filtro de comandos, deberá cumplir los siguientes criterios:

  • Debe tener un identificador de comando válido.

  • Si el valor de todos filtros es True, el evento debe coincidir al menos con un filtro.

  • Si el valor de todos los filtros es False, el evento no debe coincidir con ningún filtro.

  • Si el valor de los filtros es una combinación de True y False, el evento debe coincidir al menos con un filtro cuyo valor sea True y no puede coincidir con ningún filtro cuyo valor sea False.

Si no hay intervalos True definidos en la matriz, se considera que el valor de los eventos es True.

Por ejemplo, para configurar una matriz que bloquea un solo comando, utilice lo siguiente:

 
    Dim aFilterCommands(1 To (1 * 3)) As Long  
 
    'Ignore the layout command. 
    aFilterCommands(1) = visCmdLayoutDynamic  
    aFilterCommands(2) = visCmdLayoutDynamic  
    aFilterCommands(3) = False

O bien, configure una matriz que escuche únicamente al comando Enviar al fondo:

 
    Dim aFilterCommands(1 To (3 * 3)) As Long  
 
    'Pay attention to the "Send to Back" command.  
    aFilterCommands(1) = visCmdObjectSendToBack  
    aFilterCommands(2) = visCmdObjectSendToBack  
    aFilterCommands(3) = True  
 
    'Ignore any command IDs before the "Send to Back" command.  
    aFilterCommands(4) = visCmdFirst  
    aFilterCommands(5) = visCmdObjectSendToBack - 1  
    aFilterCommands(6) = False  
 
    'Ignore any command IDs after the "Send to Back" command.  
    aFilterCommands(7) = visCmdObjectSendToBack + 1  
    aFilterCommands(8) = visCmdLast  
    aFilterCommands(9) = False

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.

  • Last updated on