Share via

CView::OnDragEnter

  • Article

virtualDROPEFFECTOnDragEnter(COleDataObject*pDataObject,DWORDdwKeyState**,CPointpoint);**

Return Value

A value from the DROPEFFECT enumerated type, which indicates the type of drop that would occur if the user dropped the object at this position. The type of drop usually depends on the current key state indicated by dwKeyState. A standard mapping of keystates to DROPEFFECT values is:

  • DROPEFFECT_NONE   The data object cannot be dropped in this window.

  • DROPEFFECT_LINK for MK_CONTROL | MK_SHIFT   Creates a linkage between the object and its server.

  • DROPEFFECT_COPY for MK_CONTROL   Creates a copy of the dropped object.

  • DROPEFFECT_MOVE for MK_ALT   Creates a copy of the dropped object and delete the original object. This is typically the default drop effect, when the view can accept this data object.

For more information, see the MFC Advanced Concepts sample .

Parameters

pDataObject

Points to the COleDataObject being dragged into the drop area of the view.

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

The current mouse position relative to the client area of the view.

Remarks

Called by the framework when the mouse first enters the non-scrolling region of the drop target window. Default implementation is to do nothing and return DROPEFFECT_NONE.

Override this function to prepare for future calls to the OnDragOver member function. Any data required from the data object should be retrieved at this time for later use in the OnDragOver member function. The view should also be updated at this time to give the user visual feedback.  For more information, see the article in Visual C++ Programmer’s Guide.

CView Overview |  Class Members |  Hierarchy Chart

See Also   CView::OnDragOver, CView::OnDrop, CView::OnDropEx, CView::OnDragLeave, COleDropTarget::OnDragEnter