ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput Event

Définition

Se produit lorsque cet élément recueille du texte indépendamment du périphérique.Occurs when this element gets text in a device-independent manner.

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 

Implémente

Remarques

Important

Cet événement est peut-être déjà marqué comme géré par les implémentations internes des contrôles composites.This event might already be marked as handled by the internal implementations of composited controls. Consultez la remarque ci-dessous.See Remark below.

L' TextInput événement peut déjà être marqué comme géré par les implémentations internes des contrôles composites.The TextInput event may already be marked as handled by the internal implementations of composited controls. Par exemple, un TextBox est un contrôle composé dans lequel l' TextInput événement est déjà marqué comme géré; dans sa composition.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Les contrôles effectuent cette opération, car le contrôle doit interpréter certains types d’entrée, comme les touches de direction, comme ayant une signification particulière pour ce contrôle.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Si vous utilisez PreviewTextInput comme événement lorsque vous attachez des gestionnaires pour la saisie de texte, vous pouvez obtenir de meilleurs résultats.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Cette technique contourne la plupart des cas où la composition de contrôle a déjà marqué cet événement comme étant géré et empêche votre gestionnaire de recevoir l’événement le long de l’itinéraire d’événement.This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

L' TextInput événement permet à un composant ou une application d’écouter la saisie de texte de façon indépendante du périphérique.The TextInput event allows a component or application to listen for text input in a device-independent manner. Le clavier est le principal moyen de TextInput, mais la parole, l’écriture manuscrite et d’autres périphériques TextInputd’entrée peuvent également être déclenchés.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

En raison de combinaisons de touches, soit dans les claviers par défaut, soit via les éditeurs de méthode d’entrée, plusieurs événements clés peuvent déclencher un seul événement d’entrée de texte.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

Cet événement crée un alias pour l' TextCompositionManager.TextInput événement attaché pour cette classe, afin qu' TextInput il fasse partie de la liste des membres ContentElement de la classe lorsque est hérité en tant qu’élément de base.This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when ContentElement is inherited as a base element. Les gestionnaires d’événements attachés à l' TextInput événement sont attachés à l' TextCompositionManager.TextInput événement attaché sous-jacent et reçoivent la même instance de données d’événement.Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field TextInputEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate TextCompositionEventHandler
  • L’événement de tunneling correspondant PreviewTextInputest.The corresponding tunneling event is PreviewTextInput.

  • Substituez OnTextInput pour implémenter la gestion de classe pour cet événement dans les classes dérivées.Override OnTextInput to implement class handling for this event in derived classes.

S’applique à