IDropSource::QueryContinueDrag-Methode (oleidl.h)

  • Artikel

Bestimmt, ob ein Drag-and-Drop-Vorgang fortgesetzt, abgebrochen oder abgeschlossen werden soll. Diese Methode wird nicht direkt aufgerufen. Die OLE DoDragDrop-Funktion ruft diese Methode während eines Drag-and-Drop-Vorgangs auf.

Syntax

HRESULT QueryContinueDrag(
  [in] BOOL  fEscapePressed,
  [in] DWORD grfKeyState
);

Parameter

[in] fEscapePressed

Gibt an, ob die Esc-Taste seit dem vorherigen Aufruf von QueryContinueDrag oder doDragDrop gedrückt wurde, wenn dies der erste Aufruf von QueryContinueDrag ist. Ein TRUE-Wert gibt an, dass der Endbenutzer die Escapetaste gedrückt hat. ein FALSE-Wert gibt an, dass er nicht gedrückt wurde.

[in] grfKeyState

Der aktuelle Zustand der Tastaturmodifizierertasten auf der Tastatur. Mögliche Werte können eine Kombination aus den Flags MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON und MK_RBUTTON sein.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Ziehvorgang sollte fortgesetzt werden. Dieses Ergebnis tritt auf, wenn keine Fehler erkannt werden, die Maustaste, die den Drag-and-Drop-Vorgang startet, nicht freigegeben wurde und die ESC-Taste nicht erkannt wurde.
DRAGDROP_S_DROP
 Der Ablagevorgang sollte zum Abschluss des Ziehvorgangs erfolgen. Dieses Ergebnis tritt auf, wenn grfKeyState angibt, dass der Schlüssel, der den Drag-and-Drop-Vorgang gestartet hat, freigegeben wurde.
DRAGDROP_S_CANCEL
 Der Ziehvorgang sollte abgebrochen werden, ohne dass ein Ablagevorgang erfolgt. Dieses Ergebnis tritt auf, wenn fEscapePressedTRUE ist, was angibt, dass die Esc-Taste gedrückt wurde.

Hinweise

Die DoDragDrop-Funktion ruft QueryContinueDrag auf, wenn eine Änderung des Tastatur- oder Maustastenzustands während eines Drag-and-Drop-Vorgangs erkannt wird. QueryContinueDrag muss basierend auf dem Inhalt der Parameter grfKeyState und fEscapePressed bestimmen, ob der Drag-and-Drop-Vorgang fortgesetzt, abgebrochen oder abgeschlossen werden soll.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

Dodragdrop

IDropSource