UIElement.TextInput Olay

Tanım

Bu öğe bir cihazdan bağımsız şekilde metin aldığında gerçekleşir.Occurs when this element gets text in a device-independent manner.

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ü

TextCompositionEventHandler

Uygulamalar

Açıklamalar

Önemli

Bu olay, Oluşturucu denetimlerin iç uygulamaları tarafından zaten işlenmiş olarak işaretlenmiş olabilir.This event might already be marked as handled by the internal implementations of composited controls. Aşağıdaki açıklamayı inceleyin.See Remark below.

TextInputOlay, Oluşturucu denetimlerin iç uygulamaları tarafından zaten işlenmiş olarak işaretlenmiş olabilir.The TextInput event may already be marked as handled by the internal implementations of composited controls. Örneğin,, TextBox TextInput olayın zaten işlenmiş olarak işaretlenmiş olduğu, birleştirme içindeki bir Oluşturucu denetimidir.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Denetim bunu, denetimin bazı giriş türlerini (örneğin, ok tuşları), bu denetime özel anlamı olacak şekilde yorumlaması gerektiğinden denetler.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. PreviewTextInputMetin girişi için işleyicileri eklediğiniz olay olarak kullanırsanız, daha iyi sonuçlar alabilirsiniz.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Bu teknik, denetim kompozisyonunun bu olayı işlenmiş olarak zaten işaretlediği ve işleyicinizin olay yolu üzerinde olay almasını önleyen çoğu durumu atlamıştır.This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

TextInputOlay, bir bileşenin ya da uygulamanın metin girişini cihazdan bağımsız şekilde dinlemesine olanak sağlar.The TextInput event allows a component or application to listen for text input in a device-independent manner. Klavye, TextInput , ancak konuşma, el yazısı ve diğer giriş cihazlarının de yükseltebileceği birincil bir araçtır TextInput .The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Anahtar birleşimleri nedeniyle ya varsayılan klavyelerde ya da giriş yöntemi düzenleyicilerinde, birden çok önemli olay yalnızca bir metin girişi olayı oluşturabilir.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

Bu olay TextCompositionManager.TextInput , TextInput UIElement bir temel öğe olarak Devralındığı zaman sınıf üye listesinin bir parçası olan bu sınıf için ekli olay için bir diğer ad oluşturur.This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when UIElement is inherited as a base element. Olaya eklenen olay işleyicileri, TextInput temel alınan TextCompositionManager.TextInput ekli olaya iliştirilir ve aynı olay veri örneğini alır.Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

Yönlendirilmiş Olay BilgisiRouted Event Information

Tanımlayıcı alanıIdentifier field TextInputEvent
Yönlendirme stratejisiRouting strategy TırmanmaBubbling
TemsilciDelegate TextCompositionEventHandler
  • Karşılık gelen Tünel olayı PreviewTextInput .The corresponding tunneling event is PreviewTextInput.

  • OnTextInputTüretilmiş sınıflarda bu olay için sınıf işlemeyi uygulamak üzere geçersiz kılın.Override OnTextInput to implement class handling for this event in derived classes.

Şunlara uygulanır