PresentationSource.AddSourceChangedHandler Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Menambahkan handler untuk SourceChanged peristiwa ke elemen yang disediakan.

public:
 static void AddSourceChangedHandler(System::Windows::IInputElement ^ element, System::Windows::SourceChangedEventHandler ^ handler);

public static void AddSourceChangedHandler(System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);

static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit

Public Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)

Parameter

element

IInputElement

Elemen untuk menambahkan handler.

handler

SourceChangedEventHandler

Implementasi handler untuk ditambahkan.

Keterangan

Terlepas dari apa yang dinyatakan oleh blok sintaks untuk peristiwa ini, tidak ada penggunaan properti terlampir Extensible Application Markup Language (XAML) yang sah. Anda tidak boleh mencoba menambahkan handler dalam Extensible Application Markup Language (XAML), dan handler dalam kode hanya boleh ditempatkan pada objek yang berfungsi sebagai host untuk konten presentasi (PresentationSource ). Handler tersebut hanya boleh dilampirkan selama inisialisasi objek, dan harus dihapus secara eksplisit dalam metode Buang atau pembersihan objek yang setara.

Meskipun ini adalah peristiwa yang dirutekan, ada pembatasan khusus yang ditempatkan pada peristiwa ini yang berbeda dari perilaku peristiwa yang dirutekan normal, karena jumlah elemen yang relatif kecil dalam skenario aplikasi umum yang akan menyangkut diri mereka sendiri dengan penanganan peristiwa ini.

• Anda tidak dapat menggunakan UIElement metode atau ContentElementAddHandler untuk menambahkan handler. Anda harus menggunakan AddSourceChangedHandler.

• Sintaks C# += dan -= penanganan aktivitas, dan sintaks handler khusus bahasa terkait, tidak didukung, karena peristiwa itu sendiri tidak diekspos sebagai publik. PresentationSource Hanya metode utilitas untuk menambahkan dan menghapus handler secara langsung yang didukung.

• Penangan kelas tidak diperbolehkan. Secara khusus, Anda tidak dapat memanggil RegisterClassHandler peristiwa ini di konstruktor kelas karena meskipun bidang pengidentifikasi ada untuk SourceChanged, pengidentifikasi tidak bersifat publik.

• Semua handler terdaftar akan menerima peristiwa SourceChanged meskipun salah satu handler mencoba menandai argumen sebagai ditangani.