Share via


CView::OnDragEnter

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

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

パラメーター

  • pDataObject
    ビューの格納領域にドラッグ COleDataObject へのポインター。

  • dwKeyState
    修飾子キーの状態を保持します。これは、次の任意の組み合わせです: MK_CONTROLMK_SHIFTMK_ALTMK_LBUTTONMK_MBUTTONMK_RBUTTON

  • point
    ビューのクライアント領域に対するマウスの現在位置。

戻り値

DROPEFFECT の値はユーザーがこの位置でオブジェクトが削除されるドロップの種類を示す型を列挙します。ドロップの型は、通常 dwKeyStateによって示される現在の主要な状態によって異なります。DROPEFFECT の値への keystates の標準的なマッピングは次のとおりです:

  • DROPEFFECT_NONE このウィンドウでデータ オブジェクトは削除できません。

  • MK_CONTROL | MK_SHIFTDROPEFFECT_LINK は、オブジェクトとサーバー間の連結を作成します。

  • MK_CONTROLDROPEFFECT_COPY、格納オブジェクトのコピーを作成します。

  • MK_ALTDROPEFFECT_MOVE、格納オブジェクトのコピーを作成し、元のオブジェクトを削除します。これは、ビューのデータ オブジェクトを受け取る場合、通常は既定のドロップ効果です。

詳細については、MFC の高度な概念の例 OCLIENT" "を参照してください。

解説

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

OnDragOver のメンバー関数に以降のの呼び出しを準備するには、この関数をオーバーライドします。データ オブジェクトから必要なすべてのデータが OnDragOver のメンバー関数でこの場合、後で使用できるように取得する必要があります。ビューでは、ユーザーに視覚的なフィードバックを返す時点で更新する必要があります。詳細については、" " ドラッグ アンド ドロップ: ドロップ ターゲットの実行を参照してください。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CView クラス

階層図

CView::OnDragOver

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragEnter