Partager via


CView::OnDragOver

Appelé par l'infrastructure pendant une opération de glissement lorsque la souris est déplacé sur la fenêtre cible de déplacement.

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

Paramètres

  • pDataObject
    Pointe vers COleDataObject déplacé sur la cible de déplacement.

  • 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 dépend souvent de l'état de la touche actuel comme indiqué 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 recevoir l'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 fournir une aide visuelle à l'utilisateur pendant l'opération glisser. Cette fonction est appelée de façon continue, tout code contenu dans celui-ci doit être optimisé autant que possible. 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

CView, classe

Graphique de la hiérarchie

CView::OnDragEnter

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragOver