Partage via


UIElement.TextInput Événement

Définition

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.

S’applique à