COleDropTarget::OnDropEx

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

更新 : 2007 年 11 月

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

virtual DROPEFFECT OnDropEx(
   CWnd* pWnd,
   COleDataObject* pDataObject,
   DROPEFFECT dropDefault,
   DROPEFFECT dropList,
   CPoint point 
);

パラメータ

pWnd
カーソルが現在あるウィンドウへのポインタ。
pDataObject
ドロップされるデータを持つデータオブジェクトへのポインタ。
dropDefault
現在のキーの状態に基づいて、ユーザーが選択した既定のドロップ操作の結果。DROPEFFECT_NONE も設定できます。ドロップの結果の詳細については、「解説」を参照してください。
dropList
ドロップソースがサポートするドロップ操作の結果の一覧。ドロップの結果の値は、ビットごとの OR (|) 演算子で組み合わせることができます。ドロップの結果の詳細については、「解説」を参照してください。
point
画面上のカーソルの位置をピクセル単位で指定します。

戻り値

point で指定される位置でのドロップ操作の結果。ドロップの結果の詳細については、「解説」を参照してください。

解説

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

COleDropTarget::OnDropEx の既定の実装は、CView::OnDropEx を呼び出します。CView::OnDropEx は、既定では単に OnDrop メンバ関数が呼び出されることを示すダミーの値を返します。

ドロップの結果は、ドロップ操作に関連付けられた動作を説明します。以下に示すドロップの結果の一覧を参照してください。