HRESULT InPlaceActivate( LONG iVerb, const RECT* prcPosRect = NULL );
Return Value
One of the standard HRESULT values.
Parameters
iVerb
[in] Value indicating the action to be performed by IOleObjectImpl::DoVerb.
prcPosRect
[in] Pointer to the position of the in-place control.
Remarks
Causes the control to transition from the inactive state to whatever state the verb in iVerb indicates. 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 function also retrieves an IOleInPlaceSite, IOleInPlaceSiteEx, or IOleInPlaceSiteWindowless interface pointer for the control and stores it in the control class's data member m_spInPlaceSite. The control class data members m_bInPlaceSiteEx, m_bWndless, m_bWasOnceWindowless, and m_bNegotiatedWnd are set to TRUE as appropriate.