RoutedEventHandler Delegasikan

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Mewakili metode yang akan menangani berbagai peristiwa yang dirutekan yang tidak memiliki data peristiwa tertentu di luar data yang umum untuk semua peristiwa yang dirutekan.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);

public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);

type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit

Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Parameter

sender

Object

Objek tempat penanganan aktivitas dilampirkan.

e

RoutedEventArgs

Data peristiwa.

Keterangan

RoutedEventHandler Delegasi digunakan untuk setiap peristiwa yang dirutekan yang tidak melaporkan informasi khusus peristiwa dalam data peristiwa. Ada banyak peristiwa yang dirutekan seperti itu; contoh yang menonjol termasuk Click dan Loaded.

Perbedaan yang paling penting antara menulis handler untuk peristiwa yang dirutekan dibandingkan dengan peristiwa runtime bahasa umum (CLR) adalah bahwa sender peristiwa (elemen tempat handler dilampirkan dan dipanggil) tidak dapat dianggap sebagai sumber peristiwa. Sumber dilaporkan sebagai properti dalam data peristiwa (Source). Perbedaan antara sender dan Source adalah hasil dari peristiwa yang dirutekan ke elemen yang berbeda, selama traversal peristiwa yang dirutekan melalui pohon elemen.

Anda dapat menggunakan atau senderSource untuk referensi objek jika Anda sengaja tidak tertarik pada perilaku perutean peristiwa rute langsung atau menggelembung dan Anda hanya berniat untuk menangani peristiwa yang dirutekan pada elemen tempat peristiwa tersebut pertama kali dinaikkan. Dalam keadaan ini, sender dan Source merupakan objek yang sama.

Jika Anda berniat untuk memanfaatkan fitur yang melekat dari peristiwa yang dirutekan dan menulis handler Anda dengan sesuai, dua properti terpenting dari data peristiwa yang akan Anda kerjakan saat menulis penanganan aktivitas adalah Source dan Handled.

Untuk kombinasi tertentu dari peristiwa input dan kelas kontrol WPF, elemen yang menaikkan peristiwa bukanlah elemen pertama yang memiliki kesempatan untuk menanganinya. Jika peristiwa input memiliki versi Pratinjau peristiwa, maka akar pohon elemen memiliki peluang pertama, dapat diatur Handled ke true dalam data peristiwa bersama, dan dapat memengaruhi bagaimana peristiwa input dilaporkan ke elemen yang tersisa dalam rute peristiwanya. Perilaku penanganan Pratinjau dapat memberikan tampilan bahwa peristiwa rute tertentu tidak dinaikkan seperti yang diharapkan. Untuk informasi selengkapnya, lihat Pratinjau Peristiwa dan Gambaran Umum Input.

Metode Ekstensi