UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Dipanggil ketika peristiwa rute yang tidak tertangani PreviewMouseLeftButtonDown mencapai elemen dalam rutenya yang berasal dari kelas ini. Terapkan metode ini untuk menambahkan penanganan kelas untuk peristiwa ini.

protected:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected virtual void OnPreviewMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

Parameter

e

MouseButtonEventArgs

MouseButtonEventArgs yang berisi data peristiwa. Data peristiwa melaporkan bahwa tombol mouse kiri ditekan.

Keterangan

Acara ini PreviewMouseLeftButtonDown tampaknya menempuh rute penerowongan tetapi benar-benar melakukan perjalanan dengan cara yang tidak langsung. Mouse.PreviewMouseDown adalah peristiwa mendasar yang dirutekan terowongan, dan masing-masing UIElement di sepanjang rute peristiwa menggunakan penanganan yang identik untuk menaikkan peristiwa PreviewMouseLeftButtonDownrute langsung . Meskipun Anda dapat menandai peristiwa sebagai ditangani PreviewMouseLeftButtonDown untuk tujuan elemen ini, status yang ditangani tidak mengabadikan elemen lain di sepanjang rute peristiwa. Namun, Anda mungkin ingin menandai peristiwa sebagai ditangani untuk mencegah penangan instans umum (yang tidak menentukan handledEventsToo) agar tidak dipanggil.

Implementasi default untuk penanganan peristiwa mouse umum di UIElement mendengarkan Mouse.PreviewMouseDown dan mengonversinya menjadi peristiwa lokal yang sesuai. Jika Anda ingin mengambil alih logika ini, Anda harus membuat kelas turunan. Di konstruktor statis kelas turunan Anda, daftarkan penangan kelas alternatif untuk Mouse.PreviewMouseDown. Anda tidak dapat mengubah perilaku UIElement penanganan mouse dengan mengesampingkan OnPreviewMouseLeftButtonDown.

Atau, Anda dapat mengambil alih metode ini untuk mengubah penanganan peristiwa untuk status mouse tertentu. Apakah Anda memilih untuk memanggil implementasi dasar tergantung pada skenario Anda. Gagal memanggil basis menonaktifkan penanganan input default untuk peristiwa mouse tersebut pada kelas leluhur yang juga mengharapkan untuk memanggil OnPreviewMouseLeftButtonDown. Misalnya, Anda dapat memperoleh dari Button dan mengambil OnPreviewMouseLeftButtonDown alih di kelas turunan Anda tanpa memanggil implementasi dasar; namun, penimpaan ini menonaktifkan Click peristiwa.