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