Método IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)
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 |