UIElement.TextInput UIElement.TextInput UIElement.TextInput UIElement.TextInput Event

Definition

Tritt auf, wenn dieses Element Text geräteunabhängig empfängt.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 

Implementiert

Hinweise

Wichtig

Dieses Ereignis möglicherweise bereits als behandelt, indem die internen Implementierungen zusammengesetzte Steuerelemente gekennzeichnet.This event might already be marked as handled by the internal implementations of composited controls. Siehe Anmerkung unten an.See Remark below.

Die TextInput Ereignis bereits von der internen Implementierungen der zusammengesetzte Steuerelemente als behandelt markiert werden kann.The TextInput event may already be marked as handled by the internal implementations of composited controls. Z. B. eine TextBox ist ein zusammengesetztes Steuerelement, in denen die TextInput Ereignis ist bereits als behandelt, in der Zusammensetzung markiert.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Grund hierfür das Steuerelement bestimmte Arten von Eingaben, wie z. B. die Pfeiltasten, dass für das Steuerelement eine besondere Bedeutung interpretieren muss.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Bei Verwendung von PreviewTextInput des Ereignisses, in dem Sie Handler für die Texteingabe anfügen, können Sie bessere Ergebnisse erhalten.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Diese Technik umgeht den meisten Fällen, in denen steuerelementzusammensetzung hat bereits das Ereignis als behandelt markiert, und verhindert, dass den Handler empfängt das Ereignis auf der Ereignisroute.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.

Die TextInput Ereignis ermöglicht, eine Komponente oder Anwendung, die für die Texteingabe in einem geräteunabhängig überwachen.The TextInput event allows a component or application to listen for text input in a device-independent manner. Die Tastatur dient primär der TextInput, Spracherkennung, handschrifterkennung und andere Eingabegeräte können auch auslösen, aber TextInput.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Aufgrund von Tastenkombinationen – entweder in die Standard-Tastatur oder über den Eingabemethoden-Editoren - können mehrere wichtige Ereignisse nur ein Text Ereignisse auslösen.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

Dieses Ereignis erstellt einen Alias für die TextCompositionManager.TextInput angefügtes Ereignis für diese Klasse stellt, damit TextInput ist Teil der Klasse Liste der Klassenelemente UIElement als Basiselement geerbt wird.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. Ereignishandler, die angefügt sind, die TextInput Ereignis an den zugrunde liegenden angeschlossen sind TextCompositionManager.TextInput angefügtes Ereignis und die gleiche Instanz der Ereignisdaten zu empfangen.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.

Informationen zum RoutingereignisRouted Event Information

Feld "ID"Identifier field TextInputEvent
Routing-StrategieRouting strategy BubblingBubbling
delegateDelegate TextCompositionEventHandler
  • Das entsprechende tunnelingereignis ist PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Außer Kraft setzen OnTextInput um eine Klassenbehandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.Override OnTextInput to implement class handling for this event in derived classes.

Gilt für: