IOleObjectImpl::DoVerbInPlaceActivate

Runs the control and installs its window, but does not install the control's user interface.

HRESULT DoVerbInPlaceActivate(
   LPCRECT prcPosRect,
   HWND /* hwndParent */
);

Parameters

  • prcPosRec
    [in] Pointer to the rectangle the container wants the control to draw into.

  • hwndParent
    [in] Handle of the window containing the control. Not used in the ATL implementation.

Return Value

One of the standard HRESULT values.

Remarks

Activates the control in place by calling CComControlBase::InPlaceActivate. Unless the control class's data member m_bWindowOnly is TRUE, DoVerbInPlaceActivate first attempts to activate the control as a windowless control (possible only if the container supports IOleInPlaceSiteWindowless). If that fails, the function attempts to activate the control with extended features (possible only if the container supports IOleInPlaceSiteEx). If that fails, the function attempts to activate the control with no extended features (possible only if the container supports IOleInPlaceSite). If activation succeeds, the function notifies the container the control has been activated.

Requirements

Header: atlctl.h

See Also

Reference

IOleObjectImpl Class

CComControlBase::InPlaceActivate

CComControlBase::m_bWindowOnly

Other Resources

IOleObjectImpl Members