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 auf geräteunabhängige Weise abruft.
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
Important
Dieses Ereignis kann bereits durch die internen Implementierungen zusammengesetzter Steuerelemente als behandelt markiert werden. Siehe "Hinweis" weiter unten.
Das TextInput Ereignis kann bereits durch die internen Implementierungen zusammengesetzter Steuerelemente als behandelt markiert werden. Beispielsweise handelt es TextBox sich um ein zusammengesetztes Steuerelement, bei dem das TextInput Ereignis bereits als behandelt markiert ist; innerhalb der Compositing. Steuerelemente tun dies, da das Steuerelement einige Eingabetypen interpretieren muss, z. B. Pfeiltasten, die für dieses Steuerelement eine besondere Bedeutung haben. Wenn Sie als Ereignis verwenden PreviewTextInput , bei dem Sie Handler für die Texteingabe anfügen, erhalten Sie möglicherweise bessere Ergebnisse. Diese Technik umgangen die meisten Fälle, in denen die Steuerelementkomposition dieses Ereignis bereits als behandelt markiert hat, und verhindert, dass der 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 überwachen. 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 in 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 es TextInput Teil der Klassenmemberliste ist, wenn UIElement es 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 empfangen dieselbe Ereignisdateninstanz.
Routingereignisinformationen
| Element | Wert |
|---|---|
| Bezeichnerfeld | TextInputEvent |
| Routingstrategie | Bubbling |
| Delegieren | TextCompositionEventHandler |
Das entsprechende Tunneling-Ereignis ist PreviewTextInput.
Überschreiben OnTextInput , um die Klassenbehandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.
