COleDropTarget::OnDragEnter

virtual DROPEFFECT OnDragEnter( CWnd* pWnd, COleDataObject* pDataObject, DWORD dwKeyState, CPoint point );

Return Value

The effect that would result if a drop were attempted at the location specified by point. It can be one or more of the following:

DROPEFFECT_NONE A drop would not be allowed.
DROPEFFECT_COPY A copy operation would be performed.
DROPEFFECT_MOVE A move operation would be performed.
DROPEFFECT_LINK A link from the dropped data to the original data would be established.
DROPEFFECT_SCROLL A drag scroll operation is about to occur or is occurring in the target.

Parameters

pWnd

Points to the window the cursor is entering.

pDataObject

Points to the data object containing the data that can be dropped.

dwKeyState

Contains the state of the modifier keys. This is a combination of any number of the following: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, and MK_RBUTTON.

point

Contains the current location of the cursor in client coordinates.

Remarks

Called by the framework when the cursor is first dragged into the window. Override this function to allow drop operations to occur in the window. The default implementation calls CView::OnDragEnter, which simply returns DROPEFFECT_NONE by default.

For more information, see IDropTarget::DragEnter in the OLE 2 Programmer’s Reference, Volume 1.

COleDropTarget Overview | Class Members | Hierarchy Chart