CView::OnDragEnter

[アーティクル]
08/09/2011

ドロップターゲットウィンドウの非スクロール領域にマウスが最初に入ったとき、フレームワークが呼び出します。

virtual DROPEFFECT OnDragEnter(
   COleDataObject* pDataObject,
   DWORD dwKeyState,
   CPoint point 
);

パラメーター

pDataObject
ビューのドロップ領域にドラッグされた COleDataObject へのポインター。
dwKeyState
修飾子キーの状態を保持します。これは任意の数の次の組み合わせです。MK_CONTROL、 MK_SHIFT、 MK_ALT、 MK_LBUTTON、 MK_MBUTTON、および MK_RBUTTON。
point
ビューのクライアント領域からの現在のマウスの相対位置。

戻り値

DROPEFFECT 列挙型からの値を返します。この値は、ユーザーがこの位置にオブジェクトをドロップしたときに発生するドロップの型を示します。一般的にドロップの型は、dwKeyState で示される現在のキー状態に依存します。 DROPEFFECT 値に割り当てられる標準のキー状態を次に示します。

DROPEFFECT_NONE データオブジェクトは、このウィンドウにドロップすることができません。
MK_CONTROL | MK_SHIFT に対して DROPEFFECT_LINK オブジェクトとオブジェクトのサーバー間にリンクを作成します。
MK_CONTROL に対して DROPEFFECT_COPY ドロップされたオブジェクトのコピーを作成します。
MK_ALT に対して DROPEFFECT_MOVE ドロップされたオブジェクトのコピーを作成し、元のオブジェクトを削除します。一般にこれは既定のドロップ操作の結果で、ビューがデータオブジェクトを受け取ることができます。

詳細については、MFC 上級サンプルの「OCLIENT サンプル : ビジュアル編集コンテナーアプリケーションの説明」を参照してください。

解説

既定の実装では何もせず、DROPEFFECT_NONE を返します。

OnDragOver メンバー関数を将来呼び出すときの準備として、この関数をオーバーライドします。データオブジェクトから要求されるすべてのデータは、後で OnDragOver メンバー関数で使うためにこの時点で取得します。また、ユーザーがドラッグ操作中であることがわかるような表示をするために、この時点でビューを更新する必要があります。詳細についてを参照してください「ドラッグアンドドロップ:ドロップターゲットの実装。