IOleInPlaceObjectWindowlessImpl

template< class T >
class IOleInPlaceObjectWindowlessImpl

Parameters

T Your class, derived from IOleInPlaceObjectWindowlessImpl.

The IOleInPlaceObject interface manages the reactivation and deactivation of in-place controls and determines how much of the control should be visible. The IOleInPlaceObjectWindowless interface enables a windowless control to receive window messages and to participate in drag-and-drop operations. Class IOleInPlaceObjectWindowlessImpl provides a default implementation of IOleInPlaceObject and IOleInPlaceObjectWindowless and implements IUnknown by sending information to the dump device in debug builds.

Related Articles ATL Tutorial, Creating an ATL Project

#include <atlctl.h>

See Also CComControl


IOleInPlaceObjectWindowlessImpl Class Members

IOleWindow Methods
ContextSensitiveHelpEnables context-senstive help. The ATL implementation returns E_NOTIMPL.
GetWindowGets a window handle.
IOleInPlaceObject Methods
InPlaceDeactivateDeactivates an active in-place control.
ReactivateAndUndoReactivates a previously deactivated control. The ATL implementation returns E_NOTIMPL.
SetObjectRectsIndicates what part of the in-place control is visible.
UIDeactivateDeactivates and removes the user interface that supports in-place activation.
IOleInPlaceObjectWindowless Methods
GetDropTargetSupplies the IDropTarget interface for an in-place active, windowless object that supports drag and drop. The ATL implementation returns E_NOTIMPL.
OnWindowMessageDispatches a message from the container to a windowless control that is in-place active.

IOleInPlaceObjectWindowlessImpl Overview


Methods


IOleInPlaceObjectWindowlessImpl::ContextSensitiveHelp

HRESULT ContextSensitiveHelp( BOOL fEnterMode );

See IOleWindow::ContextSensitiveHelp in the Win32 SDK.

Remarks

Returns E_NOTIMPL.

IOleInPlaceObjectWindowlessImpl Overview | Class Members


IOleInPlaceObjectWindowlessImpl::GetDropTarget

HRESULT GetDropTarget( IDropTarget** ppDropTarget );

See IOleInPlaceObjectWindowless::GetDropTarget in the Win32 SDK.

Remarks

Returns E_NOTIMPL.

IOleInPlaceObjectWindowlessImpl Overview | Class Members


IOleInPlaceObjectWindowlessImpl::GetWindow

HRESULT GetWindow( HWND* phwnd );

See IOleWindow::GetWindow in the Win32 SDK.

Remarks

The container calls this function to get the window handle of the control. Some containers will not work with a control that has been windowless, even if it is currently windowed. In ATL's implementation, if the control class's data member m_bWasOnceWindowless is TRUE, the function returns E_FAIL. Otherwise, if phwnd is not NULL, GetWindow sets *phwnd to the control class's data member m_hWnd and returns S_OK.

IOleInPlaceObjectWindowlessImpl Overview | Class Members

See Also CComControl::m_bWasOnceWindowless


IOleInPlaceObjectWindowlessImpl::InPlaceDeactivate

HRESULT InPlaceDeactivate( HWND* phwnd );

See IOleInPlaceObject::InPlaceDeactivate in the Win32 SDK.

Remarks

Called by the container to deactivate an in-place active control. This method performs a full or partial deactivation depending on the state of the control. If necessary, the control's user interface is deactivated, and the control's window, if any, is destroyed. The container is notified that the control is no longer active in place. The IOleInPlaceUIWindow interface used by the container to negotiate menus and border space is released.

IOleInPlaceObjectWindowlessImpl Overview | Class Members

See Also CComControl, IOleObjectImpl::InPlaceActivate


IOleInPlaceObjectWindowlessImpl::OnWindowMessage

HRESULT OnWindowMessage( UINT msg, WPARAM WParam, LPARAM LParam, LRESULT plResultParam );

See IOleInPlaceObjectWindowless::OnWindowMessage in the Win32 SDK.

Remarks

Dispatches a message from a container to a windowless control that is in-place active.

IOleInPlaceObjectWindowlessImpl Overview | Class Members


IOleInPlaceObjectWindowlessImpl::ReactivateAndUndo

HRESULT ReactivateAndUndo( );

See IOleInPlaceObject::ReactivateAndUndo in the Win32 SDK.

Remarks

Returns E_NOTIMPL.

IOleInPlaceObjectWindowlessImpl Overview | Class Members


IOleInPlaceObjectWindowlessImpl::SetObjectRects

HRESULT SetObjectRects( LPCRECT prcPos, LPCRECT prcClip );

See IOleInPlaceObject::SetObjectRects in the Win32 SDK.

Remarks

Called by the container to inform the control its size and/or position has changed. Updates the control's m_rcPos data member and the control display. Only the part of the control that intersects the clip region is displayed. If a control's display was previously clipped but the clipping has been removed, this function can be called to redraw a full view of the control.

IOleInPlaceObjectWindowlessImpl Overview | Class Members

See Also CComControl::m_rcPos


IOleInPlaceObjectWindowlessImpl::UIDeactivate

HRESULT UIDeactivate( );

See IOleInPlaceObject::UIDeactivate in the Win32 SDK.

Remarks

Deactivates and removes the control's user interface that supports in-place activation. Sets the control class's data member m_bUIActive to FALSE. The ATL implementation of this function always returns S_OK.

IOleInPlaceObjectWindowlessImpl Overview | Class Members

See Also CComControl::m_bUIActive