UIElement.TextInput Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 kann bereits durch die internen Implementierungen von zusammengesetzten Steuerelementen behandelt werden. Siehe Hinweis unten.
Das TextInput Ereignis kann bereits durch die internen Implementierungen von zusammengesetzten Steuerelementen behandelt werden. Beispielsweise TextBox handelt es sich um ein zusammengesetztes Steuerelement, bei dem das TextInput Ereignis bereits als behandelt gekennzeichnet ist; innerhalb des Compositings. Steuerelemente führen dazu aus, da das Steuerelement einige Eingabetypen wie Pfeiltasten interpretieren muss, als besondere Bedeutung für dieses Steuerelement. Wenn Sie als Ereignis verwenden PreviewTextInput , bei dem Sie Handler für texteingaben anfügen, erhalten Sie möglicherweise bessere Ergebnisse. Diese Technik umgehen 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, Texteingaben auf geräteunabhängige Weise zu hören. Die Tastatur ist die primäre Mittel von TextInput, aber Sprache, Handschrift und andere Eingabegeräte können auch auslösen TextInput.
Aufgrund von Tastenkombinationen – entweder in Standardtasten oder über Eingabemethoden-Editoren – können mehrere Tastenereignisse nur ein Texteingabeereignis auslösen.
Dieses Ereignis erstellt einen Alias für das angefügte Ereignis für diese Klasse, sodass sie TextInput Teil der TextCompositionManager.TextInput Klassenmitgliederliste ist, wenn UIElement sie als Basiselement geerbt wird. Ereignishandler, die an das Ereignis angefügt sind, werden an das TextInput zugrunde TextCompositionManager.TextInput liegende angefügte Ereignis angefügt und erhalten dieselbe Ereignisdateninstanz.
Informationen zum Routingereignis
| Bezeichnerfeld | TextInputEvent |
| Routingstrategie | Bubbling |
| Delegat | TextCompositionEventHandler |
Das entsprechende Tunnelingereignis ist PreviewTextInput.
OnTextInput Überschreiben, um die Klassenbehandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.