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

Artículo
03/01/2024

Notifica al objeto activo en contexto cuando se activa o desactiva la ventana del documento del contenedor.

Sintaxis

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

Parámetros

[in] fActivate

Estado de la ventana del documento secundario MDI. Si este parámetro es TRUE, la ventana está activando; si es FALSE, se encuentra en el acto de desactivación.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

Notas a los autores de llamadas

Llame a IOleInPlaceActiveObject::OnDocWindowActivate cuando se activa o desactiva la ventana del documento secundario MDI y el objeto es actualmente el objeto activo del documento.

Notas para los implementadores

Debe incluir código en este método que instale herramientas de nivel de fotograma durante la activación de objetos. Estas herramientas incluyen el menú compuesto compartido y/o barras de herramientas opcionales y adornos de marco. A continuación, debe centrarse. Al desactivar, el objeto debe quitar las herramientas de nivel de marco. Tenga en cuenta que si no llama a IOleInPlaceUIWindow::SetBorderSpace con pborderwidths establecido en NULL, puede evitar tener que renegociar el espacio de borde.

Al ejecutar IOleInPlaceActiveObject::OnDocWindowActivate, no realice llamadas a las funciones PeekMessage o GetMessage ni a un cuadro de diálogo. Si lo hace, puede provocar que el sistema interbloquee. Hay más restricciones sobre qué métodos y funciones de interfaz OLE se pueden llamar desde IOleInPlaceActiveObject::OnDocWindowActivate.

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