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

  • Article

Permet à une application source d’envoyer des commentaires visuels à l’utilisateur final lors d’une opération de glisser-déplacer en fournissant à la fonction DoDragDrop une valeur d’énumération spécifiant l’effet visuel.

Syntaxe

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

Paramètres

[in] dwEffect

Valeur DROPEFFECT retournée par l’appel le plus récent à IDropTarget ::D ragEnter, IDropTarget ::D ragOver ou IDropTarget ::D ragLeave.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour Description
DRAGDROP_S_USEDEFAULTCURSORS
 Indique que la méthode a réussi et demande à OLE de mettre à jour le curseur à l’aide des curseurs par défaut fournis par OLE.

Remarques

Lorsque votre application détecte que l’utilisateur a démarré une opération de glisser-déplacer, elle doit appeler la fonction DoDragDrop . DoDragDrop entre dans une boucle, en appelant IDropTarget ::D ragEnter lorsque la souris entre pour la première fois dans une fenêtre cible de déplacement, IDropTarget ::D ragOver lorsque la souris change de position dans la fenêtre cible et IDropTarget ::D ragLeave lorsque la souris quitte la fenêtre cible.

Pour chaque appel à IDropTarget ::D ragEnter ou IDropTarget ::D ragOver, DoDragDrop appelle IDropSource ::GiveFeedback, en lui transmettant la valeur DROPEFFECT retournée par l’appel de la cible de déplacement.

DoDragDrop appelle IDropTarget ::D ragLeave lorsque la souris a quitté la fenêtre cible. Ensuite, DoDragDrop appelle IDropSource ::GiveFeedback et transmet la valeur DROPEFFECT_NONE dans le paramètre dwEffect .

Le paramètre dwEffect peut inclure DROPEFFECT_SCROLL, ce qui indique que la source doit mettre en place la variante de défilement par glisser-faire du pointeur approprié.

Remarques aux implémenteurs

Cette fonction est fréquemment appelée pendant la boucle DoDragDrop , ce qui vous permet d’obtenir des avantages en matière de performances si vous optimisez votre implémentation autant que possible.

IDropSource ::GiveFeedback est responsable de la modification de la forme du curseur ou de la source mise en surbrillance en fonction de la valeur du paramètre dwEffect . Si vous utilisez des curseurs par défaut, vous pouvez retourner DRAGDROP_S_USEDEFAULTCURSORS, ce qui oblige OLE à mettre à jour le curseur pour vous, en utilisant ses valeurs par défaut.

Configuration requise

Condition requise Valeur
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

IDropTarget