IDropSource::GiveFeedback-Methode (oleidl.h)

  • Artikel

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
DRAGDROP_S_USEDEFAULTCURSORS
 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

Weitere Informationen

Dodragdrop

IDropSource

Idroptarget