Share via


ContentElement.OnPreviewTextInput(TextCompositionEventArgs) Metode

Definisi

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

protected public:
 virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected internal virtual void OnPreviewTextInput (System.Windows.Input.TextCompositionEventArgs e);
abstract member OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
Protected Friend Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)

Parameter

e
TextCompositionEventArgs

TextCompositionEventArgs yang berisi data peristiwa.

Keterangan

Metode ini tidak memiliki implementasi default. Karena kelas perantara dalam pewarisan mungkin menerapkan metode ini, kami sarankan Anda memanggil implementasi dasar dalam implementasi Anda.

Tujuan metode ini mirip dengan metode peristiwa runtime bahasa umum (CLR) On*: metode ini menyediakan sarana untuk menangani peristiwa yang cocok dari kelas turunan dengan membuat handler kelas alih-alih handler instans. Dalam hal ini peristiwa yang cocok adalah peristiwa yang dirutekan. Pola implementasi metode On* berbeda untuk peristiwa yang dirutekan karena peristiwa yang dirutekan dapat dinaikkan oleh elemen anak, yang belum tentu merupakan elemen yang akan memanggil penangan. Oleh karena itu, implementasi Anda perlu memeriksa properti sumber data peristiwa. Ini seharusnya tidak mencoba untuk menyamarkan kembali peristiwa dalam banyak kasus.

Baik dengan mengambil alih metode ini atau dengan mendaftarkan penangan kelas dengan RegisterClassHandler, kelas turunan ContentElement dapat memanggil metode handler kelas privat ketika peristiwa diterima di sepanjang rute peristiwa. Salah satu skenario di mana penanganan kelas sesuai adalah memanipulasi data peristiwa dan menandai peristiwa yang dirutekan sebagai ditangani. Skenario lain yang khusus untuk peristiwa Pratinjau adalah menandainya ditangani sehingga penangan kelas yang cocok tidak dipanggil.

Berlaku untuk

Lihat juga