Share via

Metode IDropSource::QueryContinueDrag (oleidl.h)

  • Artikel

Menentukan apakah operasi seret dan letakkan harus dilanjutkan, dibatalkan, atau selesai. Anda tidak memanggil metode ini secara langsung. Fungsi OLE DoDragDrop memanggil metode ini selama operasi seret dan letakkan.

Sintaks

HRESULT QueryContinueDrag(
  [in] BOOL  fEscapePressed,
  [in] DWORD grfKeyState
);

Parameter

[in] fEscapePressed

Menunjukkan apakah tombol Esc telah ditekan sejak panggilan sebelumnya ke QueryContinueDrag atau ke DoDragDrop jika ini adalah panggilan pertama ke QueryContinueDrag. Nilai TRUE menunjukkan pengguna akhir telah menekan tombol escape; nilai FALSE menunjukkan belum ditekan.

[in] grfKeyState

Status tombol pengubah papan ketik saat ini pada papan ketik. Nilai yang mungkin dapat berupa kombinasi dari salah satu bendera MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON, dan MK_RBUTTON.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Operasi seret harus dilanjutkan. Hasil ini terjadi jika tidak ada kesalahan yang terdeteksi, tombol mouse yang memulai operasi seret dan letakkan belum dirilis, dan tombol Esc belum terdeteksi.
DRAGDROP_S_DROP
 Operasi penghilangan harus terjadi menyelesaikan operasi seret. Hasil ini terjadi jika grfKeyState menunjukkan bahwa kunci yang memulai operasi seret dan letakkan telah dirilis.
DRAGDROP_S_CANCEL
 Operasi seret harus dibatalkan tanpa operasi penghilangan yang terjadi. Hasil ini terjadi jika fEscapePressedTRUE, menunjukkan tombol Esc telah ditekan.

Keterangan

Fungsi DoDragDrop memanggil QueryContinueDrag setiap kali mendeteksi perubahan status keyboard atau tombol mouse selama operasi seret dan letakkan. QueryContinueDrag harus menentukan apakah operasi seret dan letakkan harus dilanjutkan, dibatalkan, atau diselesaikan berdasarkan konten parameter grfKeyState dan fEscapePressed.

Persyaratan

   
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