ContentElement.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 von den internen Implementierungen zusammengesetzter Steuerelemente als behandelt markiert werden. Siehe Bemerkung unten.
Das TextInput Ereignis kann bereits von den internen Implementierungen zusammengesetzter Steuerelemente als behandelt markiert werden. Ein TextBox ist z. B. ein zusammengesetztes Steuerelement, bei dem das TextInput Ereignis bereits als behandelt gekennzeichnet ist; innerhalb des Kompositings. Steuerelemente tun dies, da das Steuerelement einige Eingabetypen, 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.
Mit TextInput dem Ereignis kann eine Komponente oder Anwendung geräteunabhängig auf Texteingaben 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 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 dieser TextInput Teil der Klassenmemberliste ist, wenn ContentElement als Basiselement geerbt wird. Ereignishandler, die dem TextInput Ereignis angefügt sind, werden an das zugrunde liegende TextCompositionManager.TextInput angefügte Ereignis angefügt und empfangen dieselben 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.