ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput ContentElement.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 ist möglicherweise bereits als behandelt durch die internen Implementierungen von zusammengesetzten Steuerelementen gekennzeichnet.This event might already be marked as handled by the internal implementations of composited controls. Weitere Informationen finden Sie unten.See Remark below.

Das TextInput Ereignis ist möglicherweise bereits als behandelt durch die internen Implementierungen von zusammengesetzten Steuerelementen gekennzeichnet.The TextInput event may already be marked as handled by the internal implementations of composited controls. Ein TextBox ist beispielsweise ein zusammengesetzter Steuerelement, bei TextInput dem das Ereignis bereits als behandelt markiert ist, und zwar innerhalb der Zusammensetzung.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Dies geschieht, da das Steuerelement einige Typen von Eingaben, wie z. b. Pfeiltasten, interpretieren muss, um eine besondere Bedeutung für dieses Steuerelement zu haben.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Wenn Sie als PreviewTextInput Ereignis verwenden, bei dem Sie Handler für Texteingaben anfügen, erhalten Sie möglicherweise bessere Ergebnisse.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Mit dieser Technik werden die meisten Fälle umgangen, in denen die Steuerelement Komposition dieses Ereignis bereits als behandelt markiert hat und verhindert, dass der Handler das Ereignis auf der Ereignis Route empfängt.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.

Das TextInput -Ereignis ermöglicht es einer Komponente oder Anwendung, auf geräteunabhängige Weise auf Texteingaben zu lauschen.The TextInput event allows a component or application to listen for text input in a device-independent manner. Die Tastatur ist die primäre Methode von TextInput, aber sprach-, Handschrift-und andere Eingabegeräte können TextInputebenfalls eine Erhöhung durch geben.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Aufgrund von Tastenkombinationen (entweder in Standard-Tastaturen oder über Eingabemethoden-Editoren) können mehrere Schlüsselereignisse nur ein Texteingabe Ereignis aufwerfen.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 das TextCompositionManager.TextInput angefügte-Ereignis für diese Klasse, TextInput sodass Teil der Klassenmember-Liste ContentElement ist, wenn 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 ContentElement is inherited as a base element. Ereignishandler, die an das TextInput Ereignis angefügt sind, werden an das zugrunde liegende TextCompositionManager.TextInput angefügte Ereignis angefügt und empfangen dieselbe Ereignisdaten Instanz.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

BezeichnerfeldIdentifier field TextInputEvent
Routing StrategieRouting strategy BlasenBubbling
delegateDelegate TextCompositionEventHandler
  • Das entsprechende tunnelingereignis ist PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Über OnTextInput schreiben, um die Klassen Behandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.Override OnTextInput to implement class handling for this event in derived classes.

Gilt für: