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

Artigo
08/25/2023

Desativa e remove a interface do usuário de um objeto in-loco ativo.

Sintaxe

HRESULT UIDeactivate();

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_UNEXPECTED	Ocorreu um erro inesperado.

Comentários

Anotações para chamadores

Esse método é chamado pelo contêiner imediato do objeto quando, por exemplo, o usuário clicou na área do cliente fora do objeto.

Se o contêiner tiver chamado IOleInPlaceObject::UIDeactivate, ele deverá chamar IOleInPlaceObject::InPlaceDeactivate para limpo corretamente os recursos. O contêiner pode assumir que parar ou liberar o objeto limpa os recursos, se necessário. O objeto deve estar preparado para fazer isso se IOleInPlaceObject::InPlaceDeactivate não tiver sido chamado. mas IOleInPlaceObject::UIDeactivate ou IOleObject::Close foi chamado.

Anotações aos implementadores

Recursos como menus e janelas podem ser limpos ou mantidos em um estado oculto até que seu objeto seja completamente desativado por chamadas para IOleInPlaceObject::InPlaceDeactivate ou IOleObject::Close. O aplicativo de objeto deve chamar IOleInPlaceSite::OnUIDeactivate antes de fazer qualquer coisa com os menus compostos para que o contêiner possa primeiro ser desanexado da janela de quadro. Ao desativar a interface do usuário do objeto in-loco, o objeto é deixado em um estado pronto para que possa ser reativado rapidamente. O objeto permanece nesse estado até que o estado de desfazer do documento seja alterado. Em seguida, o contêiner deve chamar IOleInPlaceObject::InPlaceDeactivate para informar ao objeto para descartar seu estado de desfazer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h