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

See also

GetMessage

IOleInPlaceActiveObject

PeekMessage