Freigeben über


UIElement.TextInput Ereignis

Definition

Tritt auf, wenn dieses Element Text geräteunabhängig empfängt.

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 

Ereignistyp

Implementiert

Hinweise

Wichtig

Dieses Ereignis wird möglicherweise bereits von den internen Implementierungen zusammengesetzter Steuerelemente als behandelt markiert. Siehe Bemerkung weiter unten.

Das TextInput Ereignis wird möglicherweise bereits als von den internen Implementierungen zusammengesetzter Steuerelemente behandelt markiert. Ein TextBox ist z. B. ein zusammengesetztes Steuerelement, bei dem das TextInput Ereignis bereits als behandelt gekennzeichnet ist; innerhalb seiner Kompositing. Steuerelemente tun dies, da das Steuerelement einige Arten von Eingaben, z. B. Pfeiltasten, als besondere Bedeutung für dieses Steuerelement interpretieren muss. Wenn Sie als Ereignis verwenden PreviewTextInput , in dem Sie Handler für die Texteingabe anfügen, erhalten Sie möglicherweise bessere Ergebnisse. Diese Technik umgeht die meisten Fälle, in denen die Steuerelementkomposition dieses Ereignis bereits als behandelt markiert hat, und verhindert, dass Ihr Handler das Ereignis entlang der Ereignisroute empfängt.

Das TextInput Ereignis ermöglicht es einer Komponente oder Anwendung, auf geräteunabhängige Weise auf Texteingaben zu lauschen. Die Tastatur ist das primäre Mittel von TextInput, aber Sprache, Handschrift und andere Eingabegeräte können auch auslösen TextInput.

Aufgrund von Tastenkombinationen – entweder auf Standardtastaturen oder über Eingabemethoden-Editoren – können mehrere Tastenereignisse nur ein Texteingabeereignis auslösen.

Dieses Ereignis erstellt einen Alias für das TextCompositionManager.TextInput angefügte Ereignis für diese Klasse, sodass dieser TextInput Teil der Klassenmemberliste ist, wenn UIElement als Basiselement geerbt wird. Ereignishandler, die an das TextInput Ereignis angefügt sind, werden an das zugrunde liegende TextCompositionManager.TextInput angefügte Ereignis angefügt und erhalten die gleichen Ereignisdaten instance.

Informationen zum Routingereignis

Bezeichnerfeld TextInputEvent
Routingstrategie Bubbling
Delegat TextCompositionEventHandler
  • Das entsprechende Tunnelereignis ist PreviewTextInput.

  • Überschreiben Sie OnTextInput , um die Klassenbehandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.

Gilt für: