UIElement.Drop Kejadian
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Terjadi ketika sistem input melaporkan peristiwa penurunan yang mendasar dengan elemen ini sebagai target penghilangan.
public:
virtual event DragEventHandler ^ Drop;
// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler Drop;
function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;
Public Custom Event Drop As DragEventHandler
<uiElement Drop="eventhandler"/>
Jenis Acara
Keterangan
Agar Drop
terjadi dan memanggil handler, nilai AllowDrop pada UIElement yang merupakan target penurunan dan juga pada sumber tindakan seret-letakkan harus true
.
Handler umum akan memeriksa nilai Data dari data peristiwa DragEventArgs .
Anda dapat memulai tindakan seret-letakkan pada UIElement apa pun dengan memanggil metode StartDragAsync . Setelah tindakan dimulai, apa pun UIElement
di aplikasi berpotensi menjadi target penurunan selama AllowDrop berada true
di elemen tersebut, dan elemen apa pun yang diteruskan tindakan seret-letakkan dapat menangani DragEnter, DragLeave , atau DragOver.
Drop
adalah peristiwa yang dirutekan. Elemen harus memiliki AllowDrop menjadi true
Drop
sumber kejadian. Jika peristiwa diizinkan untuk menggelembungkan hingga elemen induk karena tidak tertangani, maka dimungkinkan untuk menangani peristiwa pada elemen induk jika AllowDrop berada true
di elemen induk. Elemen perantara dalam rute yang bukan objek handler atau target drop tidak memerlukan AllowDrop untuk menjadi true
. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.
Untuk tindakan sentuhan, tindakan seret-lepas, dan juga untuk peristiwa khusus interaksi atau manipulasi yang merupakan konsekuensi dari tindakan sentuhan, elemen harus tes temuan terlihat agar menjadi sumber peristiwa dan mengaktifkan peristiwa yang terkait dengan tindakan. UIElement.Visibility harus Terlihat. Properti lain dari jenis turunan juga memengaruhi visibilitas hit-test, misalnya IsEnabled. Untuk informasi selengkapnya, lihat Ringkasan peristiwa dan peristiwa yang dirutekan.
Drop
mendukung kemampuan untuk melampirkan penanganan aktivitas ke rute yang akan dipanggil meskipun data peristiwa untuk peristiwa ditandai Ditangani. Lihat AddHandler.
Kontrol Windows Runtime tertentu mungkin memiliki penanganan berbasis kelas untuk peristiwa tersebut Drop
. Jika demikian, logika kontrol mungkin memiliki penimpaan untuk metode OnDrop. Biasanya peristiwa ditandai ditangani oleh handler kelas, dan Drop
peristiwa tidak dinaikkan untuk ditangani oleh penangan kode pengguna apa pun pada kontrol tersebut. Untuk informasi selengkapnya, lihat Ringkasan peristiwa dan peristiwa yang dirutekan.
Terlepas dari kejadian peristiwa, beberapa kontrol dapat menggunakan animasi tema seperti DragItemThemeAnimation untuk menunjukkan perilaku seret secara visual kepada pengguna.
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk