UIElement.TextInput Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque cet élément recueille du texte indépendamment du périphérique.
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 Type d'événement
Implémente
Remarques
Important
Cet événement peut déjà être marqué comme géré par les implémentations internes de contrôles composites. Voir Remarque ci-dessous.
L’événement TextInput peut déjà être marqué comme géré par les implémentations internes de contrôles composites. Par exemple, un TextBox est un contrôle composite où l’événement TextInput est déjà marqué comme géré ; dans sa composition. Les contrôles effectuent cette opération, car ils doivent interpréter certains types d’entrée, tels que les touches de direction, comme ayant une signification particulière pour ce contrôle. Si vous utilisez PreviewTextInput comme événement où vous attachez des gestionnaires pour la saisie de texte, vous pouvez obtenir de meilleurs résultats. Cette technique contourne la plupart des cas où la composition du contrôle a déjà marqué cet événement comme géré et empêche votre gestionnaire de recevoir l’événement le long de l’itinéraire de l’événement.
L’événement TextInput permet à un composant ou à une application d’écouter l’entrée de texte de manière indépendante de l’appareil. Le clavier est le principal moyen de TextInput, mais la voix, l’écriture manuscrite et d’autres périphériques d’entrée peuvent également déclencher TextInput.
En raison des combinaisons de touches (dans les claviers par défaut ou via des éditeurs de méthode d’entrée), plusieurs événements de touches peuvent déclencher un seul événement d’entrée de texte.
Cet événement crée un alias pour l’événement TextCompositionManager.TextInput attaché pour cette classe, afin qu’il fasse partie de la liste des membres de la classe quand UIElement est hérité en tant qu’élément TextInput de base. Les gestionnaires d’événements attachés à l’événement TextInput sont attachés à l’événement attaché sous-jacent TextCompositionManager.TextInput et reçoivent les mêmes données d’événement instance.
Informations sur les événements acheminés
| Champ Identificateur | TextInputEvent |
| Stratégie de routage | Bouillonnant |
| Délégué | TextCompositionEventHandler |
L’événement de tunneling correspondant est PreviewTextInput.
Remplacement OnTextInput pour implémenter la gestion des classes pour cet événement dans les classes dérivées.
