Metode IDropSource::GiveFeedback (oleidl.h)

Memungkinkan aplikasi sumber untuk memberikan umpan balik visual kepada pengguna akhir selama operasi seret dan letakkan dengan menyediakan fungsi DoDragDrop dengan nilai enumerasi yang menentukan efek visual.

Sintaks

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

Parameter

[in] dwEffect

Nilai DROPEFFECT yang dikembalikan oleh panggilan terbaru ke IDropTarget::D ragEnter, IDropTarget::D ragOver, atau IDropTarget::D ragLeave.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
DRAGDROP_S_USEDEFAULTCURSORS	Menunjukkan keberhasilan penyelesaian metode, dan meminta OLE untuk memperbarui kursor menggunakan kursor default yang disediakan OLE.

Keterangan

Ketika aplikasi Anda mendeteksi bahwa pengguna telah memulai operasi seret dan letakkan, aplikasi tersebut harus memanggil fungsi DoDragDrop . DoDragDrop memasuki perulangan, memanggil IDropTarget::D ragEnter ketika mouse pertama kali memasuki jendela target drop, IDropTarget::D ragOver ketika mouse mengubah posisinya dalam jendela target, dan IDropTarget::D ragLeave ketika mouse meninggalkan jendela target.

Untuk setiap panggilan ke IDropTarget::D ragEnter atau IDropTarget::D ragOver, DoDragDrop memanggil IDropSource::GiveFeedback, meneruskannya nilai DROPEFFECT yang dikembalikan dari panggilan target drop.

DoDragDrop memanggil IDropTarget::D ragLeave ketika mouse telah meninggalkan jendela target. Kemudian, DoDragDrop memanggil IDropSource::GiveFeedback dan meneruskan nilai DROPEFFECT_NONE dalam parameter dwEffect .

Parameter dwEffect dapat mencakup DROPEFFECT_SCROLL, yang menunjukkan bahwa sumber harus memasang variasi pengguliran seret dari penunjuk yang sesuai.

Catatan untuk Pelaksana

Fungsi ini sering dipanggil selama perulangan DoDragDrop , sehingga Anda dapat memperoleh keuntungan performa jika Anda mengoptimalkan implementasi sebanyak mungkin.

IDropSource::GiveFeedback bertanggung jawab untuk mengubah bentuk kursor atau untuk mengubah sumber yang disorot berdasarkan nilai parameter dwEffect . Jika Anda menggunakan kursor default, Anda dapat mengembalikan DRAGDROP_S_USEDEFAULTCURSORS, yang menyebabkan OLE memperbarui kursor untuk Anda, menggunakan defaultnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h

Lihat juga

DoDragDrop

IDropSource

IDropTarget