Metode IDropTarget::D ragEnter (oleidl.h)
Menunjukkan apakah penurunan dapat diterima, dan, jika demikian, efek penurunan.
Sintaks
HRESULT DragEnter(
[in] IDataObject *pDataObj,
[in] DWORD grfKeyState,
[in] POINTL pt,
[in, out] DWORD *pdwEffect
);
Parameter
[in] pDataObj
Penunjuk ke antarmuka IDataObject pada objek data. Objek data ini berisi data yang sedang ditransfer dalam operasi seret dan letakkan. Jika penurunan terjadi, objek data ini akan dimasukkan ke dalam target.
[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.
[in] pt
Struktur POINTL yang berisi koordinat kursor saat ini dalam koordinat layar.
[in, out] pdwEffect
Pada input, arahkan ke nilai parameter pdwEffect dari fungsi DoDragDrop . Saat kembali, harus berisi salah satu bendera DROPEFFECT , yang menunjukkan hasil operasi penghilangan.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Terjadi kesalahan tidak terduga. |
|
Parameter pdwEffect adalah NULL pada input. |
|
Tidak tersedia cukup memori untuk operasi ini. |
Keterangan
Anda tidak memanggil DragEnter secara langsung; sebaliknya fungsi DoDragDrop memanggilnya untuk menentukan efek penurunan pertama kali pengguna menyeret mouse ke jendela terdaftar dari target drop.
Untuk mengimplementasikan DragEnter, Anda harus menentukan apakah target dapat menggunakan data di objek data sumber dengan memeriksa tiga hal:
- Format dan media yang ditentukan oleh objek data
- Nilai input pdwEffect
- Status kunci pengubah
Pada entri ke IDropTarget::D ragEnter, parameter pdwEffect diatur ke efek yang diberikan ke parameter pdwOkEffect dari fungsi DoDragDrop . Metode IDropTarget::D ragEnter harus memilih salah satu efek ini atau menonaktifkan penurunan.
Tombol pengubah berikut memengaruhi hasil penurunan.
Kombinasi Kunci | Umpan Balik User-Visible | Efek Jatuhkan |
---|---|---|
CTRL + SHIFT | = | DROPEFFECT_LINK |
CTRL | + | DROPEFFECT_COPY |
Tidak ada kunci atau SHIFT | Tidak ada | DROPEFFECT_MOVE |
Saat kembali, metode harus menulis efek, salah satu bendera DROPEFFECT, ke parameter pdwEffect . DoDragDrop kemudian mengambil parameter ini dan menulisnya ke parameter pdwEffect . Anda mengomunikasikan efek dropback ke sumber melalui DoDragDrop dalam parameter pdwEffect . Fungsi DoDragDrop kemudian memanggil IDropSource::GiveFeedback sehingga aplikasi sumber dapat menampilkan umpan balik visual yang sesuai kepada pengguna melalui jendela target.
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 |