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