UIElement.TextInput Kejadian

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Terjadi ketika elemen ini mendapatkan teks dengan cara yang independen perangkat.

public:
 virtual event System::Windows::Input::TextCompositionEventHandler ^ TextInput;

public event System.Windows.Input.TextCompositionEventHandler TextInput;

member this.TextInput : System.Windows.Input.TextCompositionEventHandler 

Public Custom Event TextInput As TextCompositionEventHandler 

Jenis Acara

TextCompositionEventHandler

Penerapan

TextInput

Keterangan

Penting

Kejadian ini mungkin sudah ditandai sebagai ditangani oleh implementasi internal kontrol yang dikomposisikan. Lihat Keterangan di bawah ini.

Peristiwa TextInput mungkin sudah ditandai sebagai ditangani oleh implementasi internal kontrol yang disusulkan. Misalnya, TextBox adalah kontrol yang dikomposisikan di mana TextInput peristiwa sudah ditandai sebagai ditangani; dalam kompositnya. Kontrol melakukan ini karena kontrol perlu menginterpretasikan beberapa jenis input, seperti tombol panah, seperti memiliki arti khusus untuk kontrol tersebut. Jika Anda menggunakan PreviewTextInput sebagai peristiwa di mana Anda melampirkan handler untuk input teks, Anda mungkin menerima hasil yang lebih baik. Teknik ini menghindari sebagian besar kasus di mana komposisi kontrol telah menandai peristiwa ini sebagai ditangani dan mencegah handler Anda menerima peristiwa di sepanjang rute peristiwa.

Peristiwa ini TextInput memungkinkan komponen atau aplikasi untuk mendengarkan input teks secara independen perangkat. Keyboard adalah sarana TextInpututama , tetapi ucapan, tulisan tangan, dan perangkat input lainnya juga dapat menaikkan TextInput.

Karena kombinasi kunci - baik di keyboard default atau melalui editor metode input - beberapa peristiwa kunci mungkin hanya menaikkan satu peristiwa input teks.

Kejadian ini membuat alias untuk TextCompositionManager.TextInput peristiwa terlampir untuk kelas ini, sehingga TextInput merupakan bagian dari daftar anggota kelas saat UIElement diwariskan sebagai elemen dasar. Penanganan aktivitas yang dilampirkan ke TextInput peristiwa dilampirkan ke peristiwa terlampir yang mendasar TextCompositionManager.TextInput dan menerima instans data peristiwa yang sama.

Informasi Peristiwa Yang Dirutekan

Bidang pengidentifikasi	TextInputEvent
Strategi perutean	Menggelegak
Delegasikan	TextCompositionEventHandler

• Peristiwa penerowongan yang sesuai adalah PreviewTextInput.

• Ambil alih OnTextInput untuk menerapkan penanganan kelas untuk peristiwa ini di kelas turunan.