UIElement.TextInput Olay
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bu öğe cihazdan bağımsız bir şekilde metin aldığında gerçekleşir.
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
Olay Türü
Uygulamalar
Açıklamalar
Önemli
Bu olay, bileşik denetimlerin iç uygulamaları tarafından işlendi olarak işaretlenmiş olabilir. Aşağıdaki Açıklamaya bakın.
Olay TextInput zaten bileşik denetimlerin iç uygulamaları tarafından işlendi olarak işaretlenmiş olabilir. Örneğin, a TextBox , birleştirilmiş bir denetimdir ve TextInput burada olay zaten işlendi olarak işaretlenir; birleştirme içinde. Denetimler bunu yapar çünkü denetimin ok tuşları gibi bazı giriş türlerini bu denetim için özel bir anlamı olduğu şeklinde yorumlaması gerekir. Metin girişi için işleyicileri eklediğiniz olay olarak kullanırsanız PreviewTextInput daha iyi sonuçlar alabilirsiniz. Bu teknik, denetim oluşturmanın bu olayı zaten işlendi olarak işaretlediği ve işleyicinizin olayı olay yolu boyunca almasını önlediği çoğu durumu atlatır.
Olay, TextInput bir bileşenin veya uygulamanın cihazdan bağımsız bir şekilde metin girişini dinlemesine olanak tanır. Klavye birincil aracıdır TextInput, ancak konuşma, el yazısı ve diğer giriş cihazları da oluşturabilir TextInput.
Tuş bileşimleri nedeniyle (varsayılan klavyelerde veya giriş yöntemi düzenleyicileri aracılığıyla) birden çok tuş olayı yalnızca bir metin girişi olayı tetiklenebilir.
Bu olay, temel öğe olarak devralındığında TextCompositionManager.TextInputUIElement sınıf üyeleri listesinin bir parçası olması TextInput için bu sınıf için ekli olay için bir diğer ad oluşturur. Olaya eklenen TextInput olay işleyicileri, temel alınan TextCompositionManager.TextInput ekli olaya eklenir ve aynı olay veri örneğini alır.
Yönlendirilmiş Olay Bilgisi
Tanımlayıcı alanı | TextInputEvent |
Yönlendirme stratejisi | Köpürme |
Temsilci | TextCompositionEventHandler |
Buna karşılık gelen tünel olayı şeklindedir PreviewTextInput.
Türetilmiş sınıflarda bu olay için sınıf işleme uygulamak için geçersiz kılın OnTextInput .