Compartir a través de

Interfaz IUICollectionChangedEvent (uiribbon.h)

  • Artículo

La aplicación implementa la interfaz IUICollectionChangedEvent y define el método necesario para controlar los cambios en una colección en tiempo de ejecución.

Herencia

La interfaz IUICollectionChangedEvent hereda de la interfaz IUnknown . IUICollectionChangedEvent también tiene estos tipos de miembros:

Métodos

La interfaz IUICollectionChangedEvent tiene estos métodos.

 
IUICollectionChangedEvent::OnChanged

Se llama cuando cambia una IUICollection.

Comentarios

El marco de la cinta de opciones de Windows incorpora el mecanismo estándar client-server Model (COM) de los objetos conectables para escuchar y controlar los eventos modificados de colección en tiempo de ejecución.

La cinta actúa como el objeto conectable del servidor COM que define las interfaces de notificación entrantes y salientes para el cliente, que es la aplicación host de la cinta de opciones. La cinta implementa las interfaces entrantes. La aplicación implementa las interfaces salientes en un objeto dedicado creado por la aplicación y denominado receptor de conexión de cliente. Este receptor se usa para establecer una conexión con el objeto conectable.

Además de definir las interfaces entrantes y salientes, la cinta de opciones también debe implementar la interfaz IConnectionPointContainer y crear al menos un objeto de punto de conexión que implemente la interfaz IConnectionPoint y administre la conexión con el receptor del cliente.

Nota El cliente debe consultar el objeto conectable para IConnectionPointContainer para determinar si el objeto se puede conectar antes de que el cliente intente crear un objeto receptor.
 
En el caso de la cinta de opciones, IUICollectionChangedEvent es la interfaz saliente definida por el marco e implementada por la aplicación. La cinta desencadena el evento IUICollectionChangedEvent::OnChanged en el cliente enviando una notificación saliente cuando cambia una colección, por ejemplo, agregando un comando a la barra de herramientas de acceso rápido (QAT).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiribbon.h

Consulte también

Eventos en objetos COM y conectables

Ejemplo de galería

IUICollection