Windows apps
Collapse the table of content
Expand the table of content
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::PreviewTextInput Event

 

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

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public:
event TextCompositionEventHandler^ PreviewTextInput {
	virtual void add(TextCompositionEventHandler^ value) sealed;
	virtual void remove(TextCompositionEventHandler^ value) sealed;
}

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

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

This event creates an alias for the TextCompositionManager::PreviewTextInput attached event for this class, so that PreviewTextInput is part of the class members list when UIElement is inherited as a base element. Event handlers that are attached to the PreviewTextInput event are attached to the underlying TextCompositionManager::PreviewTextInput attached event and receive the same event data instance.

Identifier field

PreviewTextInputEvent

Routing strategy

Tunneling

Delegate

TextCompositionEventHandler

  • The corresponding bubbling event is TextInput.

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

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft