Skip to content

Latest commit

 

History

History
85 lines (64 loc) · 4.17 KB

nf-oleidl-ioleinplaceactiveobject-ondocwindowactivate.md

File metadata and controls

85 lines (64 loc) · 4.17 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:oleidl.IOleInPlaceActiveObject.OnDocWindowActivate
IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)
Notifies the active in-place object when the container's document window is activated or deactivated.
IOleInPlaceActiveObject interface [COM]
OnDocWindowActivate method
IOleInPlaceActiveObject.OnDocWindowActivate
IOleInPlaceActiveObject::OnDocWindowActivate
OnDocWindowActivate
OnDocWindowActivate method [COM]
OnDocWindowActivate method [COM]
IOleInPlaceActiveObject interface
_ole_ioleinplaceactiveobject_ondocwindowactivate
com.ioleinplaceactiveobject_ondocwindowactivate
oleidl/IOleInPlaceActiveObject::OnDocWindowActivate
com\ioleinplaceactiveobject_ondocwindowactivate.htm
com
8333d707-4d34-4a87-9990-b25597ffa9fc
12/05/2018
IOleInPlaceActiveObject interface [COM],OnDocWindowActivate method, IOleInPlaceActiveObject.OnDocWindowActivate, IOleInPlaceActiveObject::OnDocWindowActivate, OnDocWindowActivate, OnDocWindowActivate method [COM], OnDocWindowActivate method [COM],IOleInPlaceActiveObject interface, _ole_ioleinplaceactiveobject_ondocwindowactivate, com.ioleinplaceactiveobject_ondocwindowactivate, oleidl/IOleInPlaceActiveObject::OnDocWindowActivate
oleidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OleIdl.Idl
Windows
19H1
IOleInPlaceActiveObject::OnDocWindowActivate
oleidl/IOleInPlaceActiveObject::OnDocWindowActivate
c++
APIRef
kbSyntax
COM
OleIdl.h
IOleInPlaceActiveObject.OnDocWindowActivate

IOleInPlaceActiveObject::OnDocWindowActivate

-description

Notifies the active in-place object when the container's document window is activated or deactivated.

-parameters

-param fActivate [in]

The state of the MDI child document window. If this parameter is TRUE, the window is in the act of activating; if it is FALSE, it is in the act of deactivating.

-returns

This method returns S_OK on success.

-remarks

Notes to Callers

Call IOleInPlaceActiveObject::OnDocWindowActivate when the MDI child document window is activated or deactivated and the object is currently the active object for the document.

Notes to Implementers

You should include code in this method that installs frame-level tools during object activation. These tools include the shared composite menu and/or optional toolbars and frame adornments. You should then take focus. When deactivating, the object should remove the frame-level tools. Note that if you do not call IOleInPlaceUIWindow::SetBorderSpace with pborderwidths set to NULL, you can avoid having to renegotiate border space.

While executing IOleInPlaceActiveObject::OnDocWindowActivate, do not make calls to the PeekMessage or GetMessage functions, or a dialog box. Doing so may cause the system to deadlock. There are further restrictions on which OLE interface methods and functions can be called from within IOleInPlaceActiveObject::OnDocWindowActivate.

-see-also

GetMessage

IOleInPlaceActiveObject

PeekMessage