Méthode IDropSource::QueryContinueDrag (oleidl.h)

  • Article

Détermine si une opération glisser-déplacer doit être poursuivie, annulée ou terminée. Vous n'appelez pas cette méthode directement. La fonction OLE DoDragDrop appelle cette méthode lors d’une opération de glisser-déplacer.

Syntaxe

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

Paramètres

[in] fEscapePressed

Indique si la touche Échap a été enfoncée depuis l’appel précédent à QueryContinueDrag ou à DoDragDrop s’il s’agit du premier appel à QueryContinueDrag. Une valeur TRUE indique que l’utilisateur final a appuyé sur la touche d’échappement ; Une valeur FALSE indique qu’elle n’a pas été enfoncée.

[in] grfKeyState

État actuel des touches de modification du clavier. Les valeurs possibles peuvent être une combinaison des indicateurs MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON et MK_RBUTTON.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 L’opération de glissement doit continuer. Ce résultat se produit si aucune erreur n’est détectée, si le bouton de la souris qui démarre l’opération de glisser-déplacer n’a pas été relâché et que la touche Échap n’a pas été détectée.
DRAGDROP_S_DROP
 L’opération de déplacement doit se produire à la fin de l’opération de glissement. Ce résultat se produit si grfKeyState indique que la clé qui a démarré l’opération glisser-déplacer a été libérée.
DRAGDROP_S_CANCEL
 L’opération de glissement doit être annulée sans opération de déplacement. Ce résultat se produit si fEscapePressed a la valeur TRUE, indiquant que la touche Échap a été enfoncée.

Notes

La fonction DoDragDrop appelle QueryContinueDrag chaque fois qu’elle détecte une modification de l’état du clavier ou du bouton de la souris pendant une opération de glisser-déplacer. QueryContinueDrag doit déterminer si l’opération glisser-déplacer doit être poursuivie, annulée ou terminée en fonction du contenu des paramètres grfKeyState et fEscapePressed.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête oleidl.h

Voir aussi

DoDragDrop

IDropSource