Partager via


CView::OnDragEnter

Appelé par l'infrastructure lorsque la souris se trouve en premier la zone non défilement de la fenêtre de cible de déplacement.

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

Paramètres

  • pDataObject
    Pointe vers COleDataObject déplacé dans la zone de déplacement de la vue.

  • dwKeyState
    Contient l'état des touches de modification.Il s'agit d'une combinaison de plusieurs des éléments suivants : MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, et MK_RBUTTON.

  • point
    La position de la souris actuelle par rapport à la zone cliente de la vue.

Valeur de retour

Une valeur d'énumération DROPEFFECT a le type, qui indique le type de blocage qui se produit si l'utilisateur supprimait l'objet à cette position.Le type de déplacement généralement dépend de l'état de la touche actuelle indiquée par dwKeyState.Un mappage standard des keystates aux valeurs d' DROPEFFECT est :

  • DROPEFFECT_NONE l'objet de données ne peut pas être supprimé dans cette fenêtre.

  • DROPEFFECT_LINK pour MK_CONTROL | MK_SHIFT crée une liaison entre l'objet et son serveur.

  • DROPEFFECT_COPY pour MK_CONTROL crée une copie de l'objet supprimé.

  • DROPEFFECT_MOVE pour MK_ALT crée une copie de l'objet supprimé et supprime l'objet d'origine.Il s'agit généralement l'effet de déplacement par défaut, lorsque la vue peut accepter cet objet de données.

Pour plus d'informations, consultez l'exemple OCLIENTde concepts avancés par MFC.

Notes

L'implémentation par défaut consiste à ne rien et de retourner DROPEFFECT_NONE.

Remplacez cette fonction pour préparer les futurs appels à la fonction membre d' OnDragOver .Tout nécessaires de l'objet de données doivent être récupérés à ce temps pour une utilisation ultérieure dans la fonction membre d' OnDragOver .La vue doit également être mise à jour à ce stade de fournir une aide visuelle pour l'utilisateur.Pour plus d'informations, consultez l'article glisser-déplacer : implémenter une cible de déplacement.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

Classe de modèle CView

Graphique de la hiérarchie

CView::OnDragOver

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragEnter