Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

UIElement.TextInput Event

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

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
public event TextCompositionEventHandler TextInput
<object TextInput="TextCompositionEventHandler" .../>

Implements

IInputElement.TextInput

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.

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

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.