ContentElement.TextInput Événement

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

L’événement TextInput peut déjà être marqué comme géré par les implémentations internes des contrôles composites. Par exemple, il TextBox s’agit d’un contrôle composite où l’événement TextInput est déjà marqué comme géré ; dans sa composition. Les contrôles le font, car le contrôle doit interpréter certains types d’entrée, tels que les touches de direction, comme avoir une signification spéciale pour ce contrôle. Si vous utilisez PreviewTextInput comme événement où vous attachez des gestionnaires pour l’entrée de texte, vous pouvez recevoir 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 d’é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 moyen principal de TextInput, mais la parole, l’écriture manuscrite et d’autres périphériques d’entrée peuvent également déclencher TextInput.

En raison de combinaisons de touches (claviers par défaut ou par le biais d’éditeurs de méthode d’entrée), plusieurs événements de touche 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, de sorte qu’il TextInput fait partie de la liste des membres de classe lorsqu’il ContentElement est hérité en tant qu’élément 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 la même instance de données d’événement.

Informations sur les événements routés

• L’événement de tunneling correspondant est PreviewTextInput.

• Remplacez OnTextInput l’implémentation de la gestion des classes pour cet événement dans les classes dérivées.