IUICollectionChangedEvent-Schnittstelle (uiribbon.h)

Die IUICollectionChangedEvent-Schnittstelle wird von der Anwendung implementiert und definiert die Methode, die zum Verarbeiten von Änderungen an einer Sammlung zur Laufzeit erforderlich ist.

Vererbung

Die IUICollectionChangedEvent-Schnittstelle erbt von der IUnknown-Schnittstelle . IUICollectionChangedEvent verfügt auch über folgende Membertypen:

Methoden

Die IUICollectionChangedEvent-Schnittstelle verfügt über diese Methoden.

IUICollectionChangedEvent::OnChanged Wird aufgerufen, wenn sich eine IUICollection ändert.

Hinweise

Das Windows-Menübandframework enthält den standardmäßigen COM-Client-Server-Mechanismus (Component Object Model) von anschließbaren Objekten , um zur Laufzeit auf geänderte Sammlungsereignisse zu lauschen und diese zu behandeln.

Das Menüband fungiert als anschließbares COM-Serverobjekt, das sowohl eingehende als auch ausgehende Benachrichtigungsschnittstellen für den Client definiert, bei dem es sich um die Menübandhostanwendung handelt. Die eingehenden Schnittstellen werden vom Menüband implementiert. Die ausgehenden Schnittstellen werden von der Anwendung in einem dedizierten Objekt implementiert, das von der Anwendung erstellt und als Clientverbindungssenke bezeichnet wird. Diese Senke wird verwendet, um eine Verbindung mit dem zu verbindenden Objekt herzustellen.

Zusätzlich zum Definieren der eingehenden und ausgehenden Schnittstellen muss das Menüband auch die IConnectionPointContainer-Schnittstelle implementieren und mindestens ein Verbindungspunktobjekt erstellen, das die IConnectionPoint-Schnittstelle implementiert und die Verbindung mit der Clientsenke verwaltet.

Hinweis Der Client muss das verbindungsfähige Objekt für IConnectionPointContainer abfragen, um zu bestimmen, ob das Objekt verbunden ist, bevor der Client versucht, ein Senkenobjekt zu erstellen.

 

Im Fall des Menübands ist IUICollectionChangedEvent die ausgehende Schnittstelle, die vom Framework definiert und von der Anwendung implementiert wird. Das Menüband löst das IUICollectionChangedEvent::OnChanged-Ereignis im Client aus, indem eine ausgehende Benachrichtigung gesendet wird, wenn sich eine Sammlung ändert, z. B. durch Hinzufügen eines Befehls zur Schnellzugriffssymbolleiste (QAT).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiribbon.h

Weitere Informationen

Ereignisse in COM und verbindungsfähigen Objekten

Katalogbeispiel

IUICollection