UIElement.DragOver Kejadian

Definisi

Terjadi ketika sistem input melaporkan peristiwa seret yang mendasar dengan elemen ini sebagai target penurunan potensial.

public:
 virtual event DragEventHandler ^ DragOver;
// Register
event_token DragOver(DragEventHandler const& handler) const;

// Revoke with event_token
void DragOver(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::DragOver_revoker DragOver(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler DragOver;
function onDragOver(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragover", onDragOver);
uIElement.removeEventListener("dragover", onDragOver);
- or -
uIElement.ondragover = onDragOver;
Public Custom Event DragOver As DragEventHandler 
<uiElement DragOver="eventhandler"/>

Jenis Acara

Keterangan

Agar DragOver terjadi, nilai AllowDrop pada UIElement saat ini dan pada sumber peristiwa harus benar. Jika tidak, pertimbangkan untuk menggunakan PointerMoved.

Anda dapat memulai tindakan seret-letakkan pada UIElement apa pun dengan memanggil metode StartDragAsync . Setelah tindakan dimulai, UIElement apa pun dalam aplikasi berpotensi menjadi target penurunan selama AllowDropbenar pada elemen tersebut. Elemen apa pun yang diteruskan tindakan seret-letakkan dapat menangani DragEnter, DragLeave , atau DragOver.

DragOver adalah peristiwa yang dirutekan. 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 di-hit-test agar dapat menjadi sumber peristiwa dan menembakkan 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 Gambaran umum peristiwa dan peristiwa yang dirutekan.

DragOver 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 DragOver. Jika demikian, kontrol mungkin memiliki penimpaan untuk metode OnDragOver. Biasanya peristiwa ditandai ditangani oleh handler kelas, dan peristiwa DragOver tidak dinaikkan untuk penanganan oleh penangan kode pengguna apa pun pada kontrol tersebut. Untuk informasi selengkapnya, lihat Gambaran umum 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.

Windows 8/Windows 8.1 Sebelum Windows 10, implementasi Windows Runtime dari konsep seret-lepas hanya mengizinkan kontrol dan tindakan input tertentu untuk memulai tindakan seret-lepas. Tidak ada metode StartDragAsync atau DoDragDrop umum yang akan mengizinkan elemen UI apa pun untuk memulai tindakan drag-drop. Sumber utama tindakan seret-letakkan di aplikasi adalah saat Anda menyeret item daftar seperti GridView.

Berlaku untuk

Lihat juga