CComControlBase::InPlaceActivate

Causes the control to transition from the inactive state to whatever state the verb in iVerb indicates.

HRESULT InPlaceActivate(
   LONG iVerb,
   const RECT* prcPosRect = NULL 
);

Parameters

  • iVerb
    Value indicating the action to be performed by IOleObjectImpl::DoVerb.

  • prcPosRect
    Pointer to the position of the in-place control.

Return Value

One of the standard HRESULT values.

Remarks

Before activation, this method checks that the control has a client site, checks how much of the control is visible, and gets the control's location in the parent window. After the control is activated, this method activates the control's user interface and tells the container to make the control visible.

This method also retrieves an IOleInPlaceSite, IOleInPlaceSiteEx, or IOleInPlaceSiteWindowless interface pointer for the control and stores it in the control class's data member CComControlBase::m_spInPlaceSite. The control class data members CComControlBase::m_bInPlaceSiteEx, CComControlBase::m_bWndLess, CComControlBase::m_bWasOnceWindowless, and CComControlBase::m_bNegotiatedWnd are set to true as appropriate.

Requirements

Header: atlctl.h

See Also

Reference

CComControlBase Class

Other Resources

CComControlBase Members