Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Especifica una matriz de tipos de objeto y un valor True o False que indica cómo filtrar eventos para cada objeto.
Sintaxis
expresión.
SetFilterObjects( _Objects()_ )
expresión Variable que representa un objeto Event .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| Objects() | Necesario | Long | Matriz de tipos de objetos y un valor True o False que indica cómo se van a filtrar los eventos de cada tipo de objeto. |
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 SetFilterObjects proporciona una manera de omitir eventos seleccionados según el tipo de objeto.
El parámetro Objects() que se pasa a SetFilterObjects es una matriz definida de la manera siguiente:
El número de elementos de la matriz es un múltiple de 2:
El primer elemento contiene un tipo de objeto (uno de visTypePage, visTypeGroup, visTypeShape, visTypeForeignObject, visTypeGuide o visTypeDoc).
El segundo elemento contiene un valor True o False, que indica si se escuchan los eventos de ese objeto (True para escuchar los eventos de un objeto; False para excluir los eventos de un objeto).
Para que un evento pase correctamente un filtro de eventos de un objeto, deberá cumplir los siguientes criterios:
Debe ser un tipo de objeto 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, si desea escuchar únicamente los eventos cuyo origen es una forma o una guía, puede pasar una matriz como la siguiente:
Dim aFilterObjects(1 To (2 * 2)) As Long
aFilterObjects(1) = visTypeShape
aFilterObjects(2) = True
aFilterObjects(3) = visTypeGuide
aFilterObjects(4) = True
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.