PresentationSource.AddSourceChangedHandler Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Menambahkan handler untuk peristiwa SourceChanged 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 metode UIElement atau ContentElementAddHandler untuk menambahkan handler. Anda harus menggunakan AddSourceChangedHandler.

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

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

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