Interface IUICollectionChangedEvent (uiribbon.h)

L’interface IUICollectionChangedEvent est implémentée par l’application et définit la méthode requise pour gérer les modifications apportées à une collection au moment de l’exécution.

Héritage

L’interface IUICollectionChangedEvent hérite de l’interface IUnknown. IUICollectionChangedEvent a également les types de membres suivants :

Méthodes

L’interface IUICollectionChangedEvent contient ces méthodes.

IUICollectionChangedEvent ::OnChanged Appelé lorsqu’un IUICollection change.

Remarques

L’infrastructure du ruban Windows intègre le mécanisme client-serveur COM (Component Object Model) standard d’objets connectables pour écouter et gérer les événements modifiés de collection au moment de l’exécution.

Le ruban agit comme l’objet connectable du serveur COM qui définit à la fois les interfaces de notification entrante et sortante pour le client, qui est l’application hôte du ruban. Les interfaces entrantes sont implémentées par le ruban. Les interfaces sortantes sont implémentées par l’application dans un objet dédié créé par l’application et appelé récepteur de connexion client. Ce récepteur est utilisé pour établir une connexion à l’objet connectable.

Outre la définition des interfaces entrantes et sortantes, le ruban doit également implémenter l’interface IConnectionPointContainer et créer au moins un objet de point de connexion qui implémente l’interface IConnectionPoint et gère la connexion avec le récepteur client.

Note Le client doit interroger l’objet connectable pour que IConnectionPointContainer détermine si l’objet est connectable avant que le client tente de créer un objet récepteur.

 

Dans le cas du ruban, IUICollectionChangedEvent est l’interface sortante définie par l’infrastructure et implémentée par l’application. Le ruban déclenche l’événement IUICollectionChangedEvent ::OnChanged dans le client en envoyant une notification sortante lorsqu’une collection change, par exemple en ajoutant une commande à la barre d’outils Accès rapide (QAT).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiribbon.h

Voir aussi

Événements dans les objets COM et connectables

Exemple de galerie

IUICollection