Método IOleInPlaceObject::UIDeactivate (oleidl.h)

Artículo
03/01/2024

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