COleDropTarget::OnDrop

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ドロップ操作が発生するときにフレームワークから呼び出されます。

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

パラメータ

pWnd
カーソルが現在あるウィンドウへのポインタ。
pDataObject
ドロップされるデータを持つデータオブジェクトへのポインタ。
dropEffect
ユーザーが選択したドロップ操作の結果。次の値の 1 つ以上を組み合わせて指定できます。
- DROPEFFECT_COPY コピー操作が実行されます。
- DROPEFFECT_MOVE 移動操作が実行されます。
- DROPEFFECT_LINK ドロップされたデータと元のデータがリンクされます。
point
画面上のカーソルの位置をピクセル単位で指定します。

戻り値

ドロップが成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

フレームワークは、まず OnDropEx を呼び出します。OnDropEx 関数がドロップを扱わない場合は、フレームワークはメンバ関数 OnDrop を呼び出します。通常、アプリケーションはビュークラスの OnDropEx をオーバーライドすることで、マウスの右ボタンでのドラッグアンドドロップを扱います。通常、ビュークラス OnDrop は単純なドラッグアンドドロップ処理に使用されます。

COleDropTarget::OnDrop の既定の実装は、CView::OnDrop を呼び出します。この関数は、既定では単に FALSE を返します。

詳細については、Windows SDK の「IDropTarget::Drop」を参照してください。