IDropSource::QueryContinueDrag-Methode (oleidl.h)
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 |
---|---|
|
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. |
|
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. |
|
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 |