UIElement.TextInput UIElement.TextInput UIElement.TextInput UIElement.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 essere già stato contrassegnato come gestito dalle implementazioni interne dei controlli compositi.This event might already be marked as handled by the internal implementations of composited controls. Vedere il commento di seguito.See Remark below.

L' TextInput evento può essere già contrassegnato come gestito dalle implementazioni interne dei controlli compositi.The TextInput event may already be marked as handled by the internal implementations of composited controls. Ad esempio, un TextBox oggetto è un controllo composito in TextInput cui l'evento è già contrassegnato come gestito; all'interno della relativa composizione.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. I controlli lo eseguono perché il controllo deve interpretare alcuni tipi di input, ad esempio i tasti di direzione, che hanno un significato speciale per quel 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 come evento in cui si alleghino i gestori per l'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 aggira la maggior parte dei casi in cui la composizione del controllo ha già contrassegnato questo evento come gestito e impedisce al gestore di ricevere l'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.

L' TextInput evento consente a un componente o a un'applicazione di restare 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 di TextInput, ma può anche generare TextInputun riconoscimento vocale, una grafia e altri dispositivi di input.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

A causa delle combinazioni di tasti, nelle tastiere predefinite o negli editor del metodo di input, 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 crea un alias per l' TextCompositionManager.TextInput evento associato per questa classe, che TextInput fa parte dell'elenco dei membri della classe quando UIElement 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 UIElement is inherited as a base element. I gestori di eventi collegati all' TextInput evento sono associati all'evento associato sottostante TextCompositionManager.TextInput e ricevono la stessa istanza di dati 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 identificatoreIdentifier field TextInputEvent
Strategia di routingRouting strategy BubblingBubbling
delegatoDelegate TextCompositionEventHandler
  • L'evento di tunneling corrispondente PreviewTextInputè.The corresponding tunneling event is PreviewTextInput.

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

Si applica a