COleDropTarget::OnDragEnter

Called by the framework when the cursor is first dragged into the window.

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

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.

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.

Remarks

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 theWindows SDK.

Requirements

Header: afxole.h

See Also

Reference

COleDropTarget Class

Hierarchy Chart

COleDropTarget::OnDragOver

COleDropTarget::OnDragLeave

COleDropTarget::OnDrop

COleDropTarget::OnDropEx

CView::OnDragEnter

Other Resources

COleDropTarget Members