Méthode IDropSource ::GiveFeedback (oleidl.h)
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 |
|---|---|
|
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 |