Método IOleInPlaceSiteEx::RequestUIActivate (ocidl.h)
Notifica al contenedor que el objeto está a punto de especificar el estado activo de la interfaz de usuario.
Sintaxis
HRESULT RequestUIActivate();
Valor devuelto
Este método devuelve S_OK si el objeto puede continuar el proceso de activación y llamar a IOleInPlaceSite::OnUIActivate. Otros posibles valores devueltos son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El objeto no puede especificar el estado activo de la interfaz de usuario. El objeto debe llamar a IOleInPlaceSite::OnUIDeactivate para que el contenedor pueda realizar el procesamiento necesario para restaurar el foco. |
|
Error en la operación. |
Comentarios
Un objeto llama a este método para determinar si puede entrar en el estado activo de la interfaz de usuario y notificar al contenedor que está a punto de realizar esta transición. El contenedor puede devolver S_FALSE denegar esta solicitud, por ejemplo, si el usuario final ha cancelado la operación o si el objeto activo actualmente no renunciará a su estado activo.
Si el objeto no llama a IOleInPlaceSiteEx::RequestUIActivate, el contenedor controla la validación de datos y desencadena eventos Enter y Exit de IOleInPlaceSite::OnUIActivate.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ocidl.h |