CView::OnDragOver

Aufgerufen vom Framework während eines Ziehvorgangs, wenn die Maus über das Ablagezielfenster bewegt wird.

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

Parameter

  • pDataObject
    Zeigt auf COleDataObject, das über das Ablageziel gezogen wird.

  • dwKeyState
    Enthält den Zustand der Modifizierertasten.Dies ist eine Kombination einer beliebigen Anzahl der folgenden: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON und MK_RBUTTON.

  • point
    Die aktuelle Mausposition relativ zum Ansichtsclientbereich.

Rückgabewert

Ein Wert vom DROPEFFECT Aufzählungstyp, der den Typ der Ablegevorgang angibt, der auftreten kann, wenn der Benutzer das Objekt an dieser Position ablegte.Der Typ der Ablegevorgang hängt häufig vom aktuellen Tastenzustand ab, wie durch dwKeyState angegeben.Eine Standardzuordnung von keystates zu DROPEFFECT-Werten ist:

  • DROPEFFECT_NONE das Datenobjekt kann nicht in diesem Fenster abgelegt werden.

  • DROPEFFECT_LINK für MK_CONTROL | MK_SHIFT erstellt eine Bindung zwischen dem Objekt und seinem Server.

  • DROPEFFECT_COPY für MK_CONTROL wird eine Kopie des abgelegten Objekts.

  • DROPEFFECT_MOVE für MK_ALT wird eine Kopie des abgelegten Objekts und löscht das ursprüngliche Objekt.Dies ist in der Regel der standardmäßige Ablageeffekt, wenn die Ansicht das Datenobjekt akzeptieren kann.

Weitere Informationen finden Sie unter, dass MFC Konzeptbeispiel OCLIENT erweiterte.

Hinweise

Die Standardimplementierung ist, nichts unternehmen und DROPEFFECT_NONE zurückzugeben.

Überschreiben Sie diese Funktion, um das visuelle Benutzerfeedback während des Ziehvorgangs zu geben.Da diese Funktion kontinuierlich aufgerufen wird, sollte jeder Code, der in diesem enthalten ist, so weit wie möglich optimiert werden.Weitere Informationen finden Sie im Artikel Drag & Drop: Implementieren eines Ablageziels.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CView-Klasse

Hierarchien-Diagramm

ProjectSubType-Element (Visual Studio-Vorlagen)

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragOver