Share via


CView::OnDrop

Called by the framework when the user releases a data object over a valid drop target.

virtual BOOL OnDrop( 
   COleDataObject* pDataObject, 
   DROPEFFECT dropEffect, 
   CPoint point  
);

Parameters

  • pDataObject
    Points to the COleDataObject that is dropped into the drop target.

  • dropEffect
    The drop effect that the user has requested.

    • DROPEFFECT_COPY   Creates a copy of the data object being dropped.

    • DROPEFFECT_MOVE   Moves the data object to the current mouse location.

    • DROPEFFECT_LINK   Creates a link between a data object and its server.

  • point
    The current mouse position relative to the view client area.

Return Value

Nonzero if the drop was successful; otherwise 0.

Remarks

The default implementation does nothing and returns FALSE.

Override this function to implement the effect of an OLE drop into the client area of the view. The data object can be examined via pDataObject for Clipboard data formats and data dropped at the specified point.

Note

The framework does not call this function if there is an override to OnDropEx in this view class.

Requirements

Header: afxwin.h

See Also

Reference

CView Class

Hierarchy Chart

CView::OnDragEnter

CView::OnDragOver

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDrop

Other Resources

CView Members