UIElement.TextInput Событие

Определение

Происходит при получении этим элементом текста аппаратно-независимым способом.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 

Реализации

Комментарии

Важно!

Это событие может уже быть помечено как обработанное внутренними реализациями составных элементов управления.This event might already be marked as handled by the internal implementations of composited controls. См. Примечание ниже.See Remark below.

Событие TextInput может уже быть помечено как обработанное внутренними реализациями составных элементов управления.The TextInput event may already be marked as handled by the internal implementations of composited controls. Например, TextBox является составным элементом управления, в котором событие TextInput уже помечено как обработанное; в его композиции.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. Если вы используете PreviewTextInput в качестве события, в котором вы присоединяете обработчики для ввода текста, вы можете получить лучшие результаты.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.

Событие TextInput позволяет компоненту или приложению ожидать ввода текста независимым от устройства образом.The TextInput event allows a component or application to listen for text input in a device-independent manner. Клавиатура является основным средством TextInput, но при этом также могут вызываться TextInputречи, рукописного ввода и других устройств ввода.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.

Это событие создает псевдоним для TextCompositionManager.TextInput присоединенного события для этого класса, поэтому TextInput является частью списка членов класса, когда UIElement наследуется как базовый элемент.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. Обработчики событий, присоединенные к событию TextInput, присоединяются к базовому TextCompositionManager.TextInput присоединенному событию и получают тот же экземпляр данных события.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.

Сведения о маршрутизируемом событииRouted Event Information

Поле идентификатораIdentifier field TextInputEvent
Стратегия маршрутизацииRouting strategy Восходящей маршрутизацииBubbling
делегатDelegate TextCompositionEventHandler
  • Соответствующее событие туннелирования — PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Переопределите OnTextInput, чтобы реализовать обработку класса для этого события в производных классах.Override OnTextInput to implement class handling for this event in derived classes.

Применяется к