Método IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)

Artigo
03/13/2024

Notifica o objeto in-loco ativo quando a janela do documento do contêiner é ativada ou desativada.

Sintaxe

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

Parâmetros

[in] fActivate

O estado da janela de documento filho da MDI. Se esse parâmetro for TRUE, a janela estará no ato de ativar; se for FALSE, ele estará no ato de desativar.

Retornar valor

Esse método retorna S_OK em caso de êxito.

Comentários

Anotações aos Chamadores

Chame IOleInPlaceActiveObject::OnDocWindowActivate quando a janela do documento filho da MDI estiver ativada ou desativada e o objeto for atualmente o objeto ativo do documento.

Observações aos implementadores

Você deve incluir o código nesse método que instala ferramentas no nível do quadro durante a ativação do objeto. Essas ferramentas incluem o menu composto compartilhado e/ou barras de ferramentas opcionais e adornos de quadro. Em seguida, você deve se concentrar. Ao desativar, o objeto deve remover as ferramentas no nível do quadro. Observe que, se você não chamar IOleInPlaceUIWindow::SetBorderSpace com pborderwidths definido como NULL, poderá evitar a renegociação do espaço de borda.

Ao executar IOleInPlaceActiveObject::OnDocWindowActivate, não faça chamadas para as funções PeekMessage ou GetMessage ou uma caixa de diálogo. Isso pode fazer com que o sistema fique em deadlock. Há mais restrições sobre quais métodos e funções de interface OLE podem ser chamados de dentro de IOleInPlaceActiveObject::OnDocWindowActivate.

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