Interfaccia IUICollectionChangedEvent (uiribbon.h)

L'interfaccia IUICollectionChangedEvent viene implementata dall'applicazione e definisce il metodo necessario per gestire le modifiche apportate a una raccolta in fase di esecuzione.

Ereditarietà

L'interfaccia IUICollectionChangedEvent eredita dall'interfaccia IUnknown . IUICollectionChangedEvent include anche questi tipi di membri:

Metodi

L'interfaccia IUICollectionChangedEvent include questi metodi.

IUICollectionChangedEvent::OnChanged Chiamato quando viene modificato un oggetto IUICollection.

Commenti

Il framework della barra multifunzione di Windows incorpora il meccanismo client COM (Component Object Model) standard di oggetti connettibili per l'ascolto e la gestione degli eventi modificati della raccolta in fase di esecuzione.

La barra multifunzione funge da oggetto connettibile server COM che definisce interfacce di notifica sia in ingresso che in uscita per il client, ovvero l'applicazione host della barra multifunzione. Le interfacce in ingresso vengono implementate dalla barra multifunzione. Le interfacce in uscita vengono implementate dall'applicazione in un oggetto dedicato creato dall'applicazione e definito sink di connessione client. Questo sink viene usato per stabilire una connessione all'oggetto connettibile.

Oltre a definire le interfacce in ingresso e in uscita, la barra multifunzione deve anche implementare l'interfaccia IConnectionPointContainer e creare almeno un oggetto punto di connessione che implementa l'interfaccia IConnectionPoint e gestisce la connessione con il sink client.

Nota Il client deve eseguire una query sull'oggetto connettibile per IConnectionPointContainer per determinare se l'oggetto è connettibile prima che il client tenti di creare un oggetto sink.

 

Nel caso della barra multifunzione, IUICollectionChangedEvent è l'interfaccia in uscita definita dal framework e implementata dall'applicazione. La barra multifunzione attiva l'evento IUICollectionChangedEvent::OnChanged nel client inviando una notifica in uscita quando viene modificata una raccolta, ad esempio aggiungendo un comando alla barra di accesso rapido (QAT).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiribbon.h

Vedi anche

Eventi in oggetti COM e connettibili

Esempio di raccolta

IUICollection