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 peut déjà être marqué comme géré par les implémentations internes des contrôles composés.This event might already be marked as handled by the internal implementations of composited controls. Consultez la Remarque ci-dessous.See Remark below.

Le TextInput événement peut déjà être marqué comme géré par les implémentations internes des contrôles composés.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é où le 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. Contrôles pour cela, car le contrôle doit interpréter certains types d’entrée, telles que 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 en tant que l’événement auquel vous attachez des gestionnaires pour l’entrée de texte, vous pouvez recevoir les meilleurs résultats.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Cette technique permet de contourner la plupart des cas où la composition de contrôle a déjà marqué cet événement comme géré et empêche votre gestionnaire de réception de 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.

Le TextInput événement permet à un composant ou une application à l’écoute pour l’entrée de texte de manière 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 moyen principal de TextInput, mais peuvent également déclencher des voix, l’écriture manuscrite et autres périphériques d’entrée TextInput.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

En raison des combinaisons de touches - dans les claviers par défaut ou à travers des éditeurs de méthode d’entrée - plusieurs événements de 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 le TextCompositionManager.TextInput joint des événements pour cette classe, afin que TextInput fait partie de la classe liste des membres lorsque ContentElement est hérité comme é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. Gestionnaires d’événements qui sont attachés à la TextInput événements sont attachés à sous-jacent TextCompositionManager.TextInput événement attaché 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 est PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Substituer 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 à