ContentElement.TextInput Olay

Tanım

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

Important

Bu olay zaten 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 , olayın zaten işlendi olarak işaretlendiği TextInput bileşik bir denetimdir; oluşturma işlemi içinde. Denetimin, ok tuşları gibi bazı giriş türlerini bu denetim için özel bir anlamı olduğu için yorumlaması gerektiğinden, denetimler bunu yapar. Metin girişi için işleyicileri eklediğiniz olay olarak kullanırsanız PreviewTextInput daha iyi sonuçlar alabilirsiniz. Bu teknik, denetim bileşiminin bu olayı zaten işlendi olarak işaretlediği ve işleyicinizin olay yolu boyunca olayı almasını önlediği çoğu durumu atlatır.

Olay, TextInput bir bileşenin veya uygulamanın metin girişini cihazdan bağımsız bir şekilde dinlemesine olanak tanır. Klavye birincil aracıdır TextInput, ancak konuşma, el yazısı ve diğer giriş cihazları da yükseltebilir TextInput.

Tuş bileşimleri (varsayılan klavyelerde veya giriş yöntemi düzenleyicileri aracılığıyla) nedeniyle, birden çok tuş olayı yalnızca bir metin girişi olayı tetikler.

Bu olay, TextCompositionManager.TextInput temel öğe olarak devralındığında TextInputContentElement sınıf üyeleri listesinin bir parçası olması 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önlendirilen Olay Bilgileri

Öğe Değer
Tanımlayıcı alanı TextInputEvent
Yönlendirme stratejisi Köpürme
Temsilci TextCompositionEventHandler
  • Buna karşılık gelen tünel olayı olur PreviewTextInput.

  • Türetilmiş sınıflarda bu olay için sınıf işleme uygulamak için geçersiz kılın OnTextInput .

Şunlara uygulanır