IDropSource::GiveFeedback-Methode (oleidl.h)
Ermöglicht einer Quellanwendung, dem Endbenutzer während eines Drag-and-Drop-Vorgangs visuelles Feedback zu geben, indem der DoDragDrop-Funktion ein Enumerationswert bereitgestellt wird, der den visuellen Effekt angibt.
Syntax
HRESULT GiveFeedback(
[in] DWORD dwEffect
);
Parameter
[in] dwEffect
Der DROPEFFECT-Wert , der vom letzten Aufruf von IDropTarget::D ragEnter, IDropTarget::D ragOver oder IDropTarget::D ragLeave zurückgegeben wird.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Werte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt den erfolgreichen Abschluss der Methode an und fordert OLE auf, den Cursor mithilfe der von OLE bereitgestellten Standardcursors zu aktualisieren. |
Hinweise
Wenn Ihre Anwendung erkennt, dass der Benutzer einen Drag-and-Drop-Vorgang gestartet hat, sollte sie die DoDragDrop-Funktion aufrufen. DoDragDrop wechselt in eine Schleife und ruft IDropTarget::D ragEnter auf, wenn die Maus zum ersten Mal in ein Dropzielfenster eintritt, IDropTarget::D ragOver , wenn die Maus ihre Position im Zielfenster ändert, und IDropTarget::D ragLeave , wenn die Maus das Zielfenster verlässt.
Für jeden Aufruf von IDropTarget::D ragEnter oder IDropTarget::D ragOver ruft DoDragDropIDropSource::GiveFeedback auf und übergibt ihm den dropEFFECT-Wert, der vom Aufruf des Ablageziels zurückgegeben wird.
DoDragDrop ruft IDropTarget::D ragLeave auf, wenn die Maus das Zielfenster verlassen hat. Dann ruft DoDragDropIDropSource::GiveFeedback auf und übergibt den DROPEFFECT_NONE-Wert im dwEffect-Parameter .
Der dwEffect-Parameter kann DROPEFFECT_SCROLL enthalten, der angibt, dass die Quelle die Drag-Scrolling-Variation des entsprechenden Zeigers einrichten soll.
Hinweise zu Implementierern
Diese Funktion wird während der DoDragDrop-Schleife häufig aufgerufen, sodass Sie Leistungsvorteile erzielen können, wenn Sie Ihre Implementierung so weit wie möglich optimieren.IDropSource::GiveFeedback ist für das Ändern der Cursorform oder für das Ändern der hervorgehobenen Quelle basierend auf dem Wert des dwEffect-Parameters verantwortlich. Wenn Sie Standardcursor verwenden, können Sie DRAGDROP_S_USEDEFAULTCURSORS zurückgeben. Dies führt dazu, dass OLE den Cursor für Sie mithilfe der Standardwerte aktualisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |