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

Definizione

Si verifica in seguito all'input di testo per l'elemento in modo indipendente dalla periferica.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 

Implementazioni

Commenti

Importante

Questo evento potrebbe già essere contrassegnato come gestito dalle implementazioni interne di controlli compositi.This event might already be marked as handled by the internal implementations of composited controls. Vedere la sezione Osservazioni riportata di seguito.See Remark below.

Il TextInput evento potrebbe già essere contrassegnato come gestito dalle implementazioni interne di controlli compositi.The TextInput event may already be marked as handled by the internal implementations of composited controls. Ad esempio, un TextBox è un controllo composito in cui il TextInput evento è già contrassegnato come gestito; entro la composizione.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Controlli di eseguire questa operazione perché il controllo deve interpretare alcuni tipi di input, ad esempio i tasti di direzione, come se avessero un significato speciale per tale controllo.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Se si usa PreviewTextInput dell'evento in cui si collegano i gestori per input di testo, è possibile ottenere risultati migliori.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Questa tecnica consente di evitare la maggior parte dei casi in cui la composizione del controllo è già contrassegnato questo evento come gestito e impedisce al gestore di ricezione dell'evento lungo la route dell'evento.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.

Il TextInput evento consente a un componente o applicazione in ascolto dell'input di testo in modo indipendente dal dispositivo.The TextInput event allows a component or application to listen for text input in a device-independent manner. La tastiera è il mezzo principale TextInput, tuttavia, riconoscimento vocale, riconoscimento della grafia e altri dispositivi di input possono anche generare TextInput.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

A causa di combinazioni di tasti - predefiniti o tramite input method editor - più eventi chiave potrebbero generare un solo evento di input di testo.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

Questo evento viene creato un alias per il TextCompositionManager.TextInput evento per questa classe, associato in modo che TextInput fa parte della classe di elenco dei membri quando ContentElement viene ereditato come elemento di 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. Gestori eventi associati al TextInput eventi sono associati all'oggetto sottostante TextCompositionManager.TextInput evento associato e ricevono la stessa istanza di dati di evento.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.

Informazioni evento indirizzatoRouted Event Information

Campo dell'identificatoreIdentifier field TextInputEvent
Strategia di routingRouting strategy BubblingBubbling
delegatoDelegate TextCompositionEventHandler
  • L'evento di tunneling corrispondente è PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Eseguire l'override OnTextInput per implementare la gestione di questo evento nelle classi derivate della classe.Override OnTextInput to implement class handling for this event in derived classes.

Si applica a