December 03, 2013
Occurs when a UI element gets text in a device-independent manner.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
This event is raised asynchronously.
Use a handler based on TextCompositionEventHandler to handle this event.
is generally only raised by elements that are already handling for key input on a per-key basis using KeyUp or KeyDown and coalescing the results, such as TextBox. is an event that is general to UIElement rather than specific to TextBox because it is a routed event that bubbles, and thus can potentially be handled by a compositing container. For example, a custom control might be interested in updates to one or more of its text box components, and might hook up at the component root level as one of the operations in its OnApplyTemplate implementation.
The event allows a component or application to listen for text input in a device-independent manner. The keyboard is the primary means of text input, but potentially custom touch gestures and other input techniques including an input method editor (IME) can also raise .
This event is a bubbling event. This means that if multiple handlers are registered for a sequence of objects connected by parent-child relationships in the object tree, the event is received by each object in that relationship, with the route going in the parent direction. The sender available to the event handler identifies the object where the event is handled, not necessarily the object that actually received the input condition that initiated the event. To get the object that initiated the event, use the OriginalSource value of the event's RoutedEventArgs event data. For more information on routed event concepts, see Events for Windows Phone.