Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

UIElement.TextInput Event

Occurs when this element gets text in a device-independent manner.

Namespace: System.Windows
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public event TextCompositionEventHandler TextInput
/** @event */
public final void add_TextInput (TextCompositionEventHandler value)

/** @event */
public final void remove_TextInput (TextCompositionEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.
<object TextInput="TextCompositionEventHandler" .../>

Identifier field

TextInputEvent

Routing strategy

Bubbling

Delegate

TextCompositionEventHandler

  • The corresponding tunneling event is PreviewTextInput.

  • Override OnTextInput to implement class handling for this event in derived classes.

NoteImportant:

This event might already be marked as handled by the internal implementations of composited controls. See Remark below.

The TextInput event may already be marked as handled by the internal implementations of composited controls. For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. 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.

The TextInput event allows a component or application to listen for text input in a device-independent manner. The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Because of key combinations—either in default keyboards or through input method editors—multiple key events might raise just one text input event.

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. 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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

Show:
© 2014 Microsoft