Metodo IOleInPlaceSiteEx::RequestUIActivate (ocidl.h)

Notifica al contenitore che sta per essere attivato lo stato di interfaccia utente attiva per l'oggetto.

Sintassi

HRESULT RequestUIActivate();

Valore restituito

Questo metodo restituisce S_OK se l'oggetto può continuare il processo di attivazione e chiamare IOleInPlaceSite::OnUIActivate. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
S_FALSE	L'oggetto non può immettere lo stato attivo dell'interfaccia utente. L'oggetto deve chiamare IOleInPlaceSite::OnUIDeactivate in modo che il contenitore possa eseguire l'elaborazione necessaria per ripristinare lo stato attivo.
E_FAIL	Operazione non riuscita.

Commenti

Un oggetto chiama questo metodo per determinare se può immettere lo stato attivo dell'interfaccia utente e per notificare al contenitore che sta per eseguire questa transizione. Il contenitore può restituire S_FALSE per negare questa richiesta, ad esempio se l'utente finale ha annullato l'operazione o se l'oggetto attualmente attivo non rimetterà lo stato attivo.

Se l'oggetto non chiama IOleInPlaceSiteEx::RequestUIActivate, il contenitore gestisce la convalida dei dati e attiva gli eventi Invio e Exit da IOleInPlaceSite::OnUIActivate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IOleInPlaceSite::OnUIActivate

IOleInPlaceSite::OnUIDeactivate

IOleInPlaceSiteEx