UIElement.MouseLeftButtonDown Kejadian

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Terjadi ketika tombol mouse kiri ditekan saat penunjuk mouse berada di atas elemen ini.

public:
 virtual event System::Windows::Input::MouseButtonEventHandler ^ MouseLeftButtonDown;

public event System.Windows.Input.MouseButtonEventHandler MouseLeftButtonDown;

member this.MouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 

Public Custom Event MouseLeftButtonDown As MouseButtonEventHandler 

Jenis Acara

MouseButtonEventHandler

Penerapan

MouseLeftButtonDown

Keterangan

Meskipun peristiwa yang dirutekan ini tampaknya mengikuti rute gelembung melalui pohon elemen, itu sebenarnya adalah peristiwa rute langsung yang dinaikkan dan dirangkai kembali di sepanjang pohon elemen oleh masing-masing UIElement.

Kejadian ini adalah salah satu dari beberapa peristiwa terkait yang melaporkan spesifik tombol mouse dari peristiwa yang mendasar Mouse.MouseDown , yang merupakan peristiwa terlampir yang diproses oleh setiap elemen di sepanjang rute peristiwa.

Data peristiwa dari peristiwa ini mengekspos data peristiwa dari peristiwa yang mendasar Mouse.MouseDown . Jika peristiwa tersebut ditandai sebagai ditangani di sepanjang rute peristiwa, peristiwa tertentu tombol mouse masih dinaikkan; namun, handler dari peristiwa tertentu tombol mouse harus ditambahkan dengan secara eksplisit memanggil AddHandler, dengan opsi untuk menangani peristiwa yang sudah ditandai sebagai ditangani, agar dapat menjadi pendengar peristiwa. Jika Anda menandai MouseLeftButtonDown ditangani, Anda pada dasarnya menandai Mouse.MouseDown ditangani untuk semua pendengar lebih lanjut di sepanjang rute, dan pada semua peristiwa terkait. Ini mungkin termasuk peristiwa yang dihasilkan penanganan kelas seperti MouseDoubleClick.

Secara konseptual, pikirkan peristiwa ini (dan peristiwa tombol mouse lainnya pada UIElement) untuk menjadi "layanan" mouse (dengan definisi layanan yang disediakan oleh Mouse kelas ). Kejadian ini menambah kenyamanan tidak perlu memeriksa status tombol mouse (kiri-kanan, atas-bawah) dari peristiwa mouse asli dalam data peristiwa. Untuk skenario yang lebih canggih, seperti memeriksa status tombol non-standar, Anda mungkin perlu menggunakan API pada Mouse kelas daripada yang ada di UIElement.

Penting

Beberapa kelas kontrol mungkin memiliki penanganan kelas yang melekat untuk peristiwa tombol mouse. Peristiwa tombol mouse kiri ke bawah adalah peristiwa yang paling mungkin memiliki penanganan kelas dalam kontrol. Penanganan kelas sering menandai peristiwa kelas yang mendasar Mouse sebagai ditangani. Setelah peristiwa ditandai ditangani, handler instans lain yang dilampirkan ke elemen tersebut biasanya tidak dinaikkan. Setiap penangan kelas atau instans lain yang melekat pada elemen ke arah gelembung ke arah akar di pohon UI juga tidak biasanya dinaikkan.

Anda dapat mengatasi masalah yang diuraikan dalam peristiwa Penting dan masih menerima MouseLeftButtonDown peristiwa untuk peristiwa tombol mouse kiri ke bawah pada kelas turunan yang memiliki penanganan kelas dengan menggunakan salah satu solusi ini:

• Lampirkan handler untuk PreviewMouseDown peristiwa, yang tidak ditandai sebagai ditangani oleh kontrol. Perhatikan bahwa karena ini adalah peristiwa pratinjau, rute dimulai di akar dan terowongan ke kontrol.

• Daftarkan handler pada kontrol secara prosedural dengan memanggil AddHandler dan memilih opsi tanda tangan yang memungkinkan penangan mendengarkan peristiwa bahkan jika mereka sudah ditandai sebagai ditangani dalam data peristiwa yang dirutekan.

Informasi Peristiwa Yang Dirutekan

Bidang pengidentifikasi	MouseLeftButtonDownEvent
Strategi perutean	Langsung
Delegasikan	MouseButtonEventHandler

• Ambil alih OnMouseLeftButtonDown untuk mengimplementasikan penanganan kelas untuk peristiwa ini di kelas turunan.

Lihat juga

• PreviewMouseLeftButtonDown