Método IOleInPlaceObject::InPlaceDeactivate (oleidl.h)
Desativa um objeto in-loco ativo e descarta o estado de desfazer do objeto.
Sintaxe
HRESULT InPlaceDeactivate();
Retornar valor
Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
Erro inesperado. |
Comentários
Anotações aos Chamadores
Esse método é chamado pelo contêiner imediato de um objeto ativo para desativar o objeto ativo e descartar seu estado de desfazer.Observações aos implementadores
No retorno de IOleInPlaceObject::InPlaceDeactivate, o objeto descarta seu estado de desfazer. O aplicativo de objeto não deve ser desligado imediatamente após essa chamada. Em vez disso, ele deve aguardar uma chamada explícita para IOleObject::Close ou para que a contagem de referência do objeto atinja zero.Antes de desativar, o aplicativo objeto deve dar ao contêiner a chance de colocar sua interface do usuário novamente na janela de quadro chamando IOleInPlaceSite::OnUIDeactivate.
Se a interface do usuário in-loco ainda estiver visível durante a chamada para IOleInPlaceObject::InPlaceDeactivate, o aplicativo de objeto deverá chamar seu próprio método IOleInPlaceObject::InPlaceDeactivate para ocultar a interface do usuário. Opcionalmente, a interface do usuário in-loco pode ser destruída durante chamadas para IOleInPlaceObject::InPlaceDeactivate e IOleInPlaceObject::InPlaceDeactivate. Mas se a interface do usuário ainda não tiver sido destruída quando o contêiner chamar IOleObject::Close, ela deverá ser destruída durante a chamada para IOleObject::Close.
Durante a chamada para IOleObject::Close, o objeto deve marcar para ver se ele ainda está ativo no local. Nesse caso, ele deve chamar IOleInPlaceObject::InPlaceDeactivate.
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 |
Confira também
IOleInPlaceSite::OnInPlaceDeactivate