Método IOleInPlaceObject::UIDeactivate (oleidl.h)
Desactiva y quita la interfaz de usuario de un objeto activo en contexto.
Sintaxis
HRESULT UIDeactivate();
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
Código devuelto | Descripción |
---|---|
|
Se produjo un error inesperado. |
Comentarios
Notas a los autores de llamadas
El contenedor inmediato del objeto llama a este método cuando, por ejemplo, el usuario ha hecho clic en el área cliente fuera del objeto.Si el contenedor ha llamado a IOleInPlaceObject::UIDeactivate, más adelante debe llamar a IOleInPlaceObject::InPlaceDeactivate para limpiar correctamente los recursos. El contenedor puede suponer que detener o liberar el objeto limpia los recursos si es necesario. El objeto debe estar preparado para hacerlo si no se ha llamado a IOleInPlaceObject::InPlaceDeactivate . pero se ha llamado a IOleInPlaceObject::UIDeactivate o IOleObject::Close .
Notas para los implementadores
Los recursos como menús y ventanas se pueden limpiar o mantener en un estado oculto hasta que el objeto se desactive por completo mediante llamadas a IOleInPlaceObject::InPlaceDeactivate o IOleObject::Close. La aplicación de objeto debe llamar a IOleInPlaceSite::OnUIDeactivate antes de hacer cualquier cosa con los menús compuestos para que el contenedor se pueda desasociar primero de la ventana de marco. Al desactivar la interfaz de usuario del objeto local, el objeto se deja en un estado listo para que se pueda reactivar rápidamente. El objeto permanece en este estado hasta que cambia el estado de deshacer del documento. A continuación, el contenedor debe llamar a IOleInPlaceObject::InPlaceDeactivate para indicar al objeto que descarte su estado de deshacer.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 | oleidl.h |
Consulte también
IOleInPlaceObject::InPlaceDeactivate
IOleInPlaceObject::ReactivateAndUndo