Windows Dev Center

IOleInPlaceActiveObject::OnFrameWindowActivate method

Notifies the object when the container's top-level frame window is activated or deactivated.

Syntax


HRESULT OnFrameWindowActivate(
  [in] BOOL fActivate
);

Parameters

fActivate [in]

The state of the container's top-level frame window. This parameter is TRUE if the window is activating and FALSE if it is deactivating.

Return value

This method returns S_OK on success.

Notes to Callers

The container must call IOleInPlaceActiveObject::OnFrameWindowActivate when the container's top-level frame window is either being activated or deactivated and the object is the current, active object for the frame.

While executing IOleInPlaceActiveObject::OnFrameWindowActivate, 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::OnFrameWindowActivate.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleInPlaceActiveObject is defined as 00000117-0000-0000-C000-000000000046

See also

GetMessage
IOleInPlaceActiveObject
PeekMessage

 

 

Community Additions

ADD
Show:
© 2015 Microsoft