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 |
|---|---|
|
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. |
|
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 |