UIElement.OnPreviewMouseUp(MouseButtonEventArgs) Metode
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.
Dipanggil ketika peristiwa terpasang yang tidak PreviewMouseUp tertangani mencapai elemen dalam rutenya yang berasal dari kelas ini. Terapkan metode ini untuk menambahkan penanganan kelas untuk peristiwa ini.
protected:
virtual void OnPreviewMouseUp(System::Windows::Input::MouseButtonEventArgs ^ e);
protected virtual void OnPreviewMouseUp (System.Windows.Input.MouseButtonEventArgs e);
abstract member OnPreviewMouseUp : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseUp : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Overridable Sub OnPreviewMouseUp (e As MouseButtonEventArgs)
Parameter
MouseButtonEventArgs yang berisi data peristiwa. Data peristiwa melaporkan bahwa satu atau beberapa tombol mouse dirilis.
Keterangan
Tindakan tombol mouse juga ditangani oleh manajer input khusus. Fitur pemrograman lain yang mengandalkan tindakan tombol mouse, seperti pengikatan input dan perintah, mungkin memanggil handler untuk tindakan sebelum diekspos sebagai tindakan tombol mouse umum. Jika fitur sistem input ini menandai Mouse.PreviewMouseUp peristiwa sebagai ditangani, OnPreviewMouseUp tidak dipanggil.
Jika Anda menggunakan handler kelas ini untuk menandai peristiwa sebagai ditangani, Anda berpotensi memengaruhi peristiwa berikut: PreviewMouseLeftButtonUp dan PreviewMouseRightButtonUp. Salah satu peristiwa ini mungkin dinaikkan pada elemen penerima ketika Mouse.PreviewMouseUp diterima.
Jika Anda menandai peristiwa ini sebagai ditangani dalam penanganan kelas, subevent masih dinaikkan; namun, mereka melewati status tertangani dalam data peristiwa. Jika peristiwa ditangani dalam penanganan kelas, penanganan instans untuk subevent tidak dipanggil kecuali Anda secara eksplisit menggunakan AddHandler(RoutedEvent, Delegate, Boolean) untuk handledEventsToo
true
melampirkan handler. Handler kelas juga tidak dipanggil kecuali penangan kelas tersebut terdaftar dengan RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) tanda tangan dengan handledEventsToo
true
. Dengan menangani OnPreviewMouseUp, Anda menyiratkan bahwa penanganan kelas Anda memperkirakan semua kemungkinan tindakan tombol mouse. Perilaku ini mungkin tidak diinginkan; Oleh karena itu, berhati-hatilah saat Anda menggunakan metode virtual ini untuk menandai peristiwa sebagai ditangani.
Masing-masing peristiwa langsung khusus tombol juga memiliki metode Virtual On*; pertimbangkan apakah mengambil alih penangan kelas khusus tombol ini mungkin lebih tepat.
Metode ini tidak memiliki implementasi default. Karena kelas perantara dalam pewarisan mungkin menerapkan metode ini, kami sarankan Anda memanggil implementasi dasar dalam implementasi Anda.
Tujuan dari metode ini mirip dengan pola peristiwa runtime bahasa umum (CLR) Pada* metode: metode ini menyediakan sarana untuk menangani peristiwa yang cocok dari kelas turunan dengan membuat handler kelas alih-alih handler instans. Dalam hal ini peristiwa yang cocok adalah peristiwa yang dirutekan. Pola implementasi metode On* berbeda untuk peristiwa yang dirutekan karena peristiwa yang dirutekan dapat dinaikkan oleh elemen anak, yang belum tentu merupakan elemen yang akan memanggil handler. Oleh karena itu, implementasi Anda perlu memeriksa properti sumber data peristiwa. Ini seharusnya tidak mencoba untuk menyusun ulang peristiwa dalam banyak kasus.
Baik dengan menimpa metode ini atau dengan mendaftarkan penangan kelas dengan RegisterClassHandler, kelas turunan UIElement dapat memanggil metode handler kelas privat ketika peristiwa diterima di sepanjang rute peristiwa. Salah satu skenario di mana penanganan kelas sesuai adalah memanipulasi data peristiwa dan menandai peristiwa yang dirutekan sebagai ditangani.
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