CView::OnDropEx

更新 : 2007 年 11 月

有効なドロップターゲット上でユーザーがデータオブジェクトを離したとき、フレームワークが呼び出します。

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

パラメータ

pDataObject
ドロップターゲットにドロップされる COleDataObject へのポインタ。
dropDefault
現在のキーの状態に基づいて、ユーザーが選択した既定のドロップ操作の結果。DROPEFFECT_NONE も設定可能です。ドロップの結果の詳細については、「解説」を参照してください。
dropList
ドロップソースがサポートするドロップ操作の結果の一覧。ドロップの結果の値は、ビットごとの OR (|) 演算子で組み合わせることができます。ドロップの結果の詳細については、「解説」を参照してください。
point
ビューのクライアント領域からの現在のマウスの相対位置。

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

既定の実装では何も行わず、フレームワークが OnDrop ハンドラを呼び出すことを示すために、ダミーの値 ( -1 ) を返します。

マウスの右ボタンを使用したドラッグアンドドロップの結果を実装するには、この関数をオーバーライドします。一般に、マウスの右ボタンを使用したドラッグアンドドロップを実行すると、右ボタンを離したときに選択メニューが表示されます。

OnDropEx をオーバーライドすると、マウスの右ボタンを問い合わせます。GetKeyState を呼び出したり、OnDragEnter ハンドラで右ボタンの状態を格納したりできます。

マウスの右ボタンが押される場合、オーバーライドをすると、ドロップソースがサポートするドロップ操作の結果のポップアップメニューが表示されます。
- ドロップソースがサポートするドロップ操作の結果を確認するには、dropList を調べます。ポップアップメニューに限り、これらの動作を有効にします。
- dropDefault. に基づいて既定の動作を設定するには、SetMenuDefaultItem を使用します。
- 最後に、ポップアップメニューでユーザーが選択した動作を実行します。
マウスの右ボタンが押されていない場合、オーバーライドすると標準のドロップ要求として処理します。dropDefault. で指定されたドロップ操作の結果を使用します。代わりに、オーバーライドするとダミーの値 ( -1 ) を返すことができ、OnDrop がこのドロップ操作を処理することを示します。