UIElement.TextInput Событие

Определение

Происходит при получении этим элементом текста аппаратно-независимым способом.

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 

Тип события

TextCompositionEventHandler

Реализации

Комментарии

Важно!

Это событие может уже быть помечено как обработанное внутренними реализациями составных элементов управления. См. Примечание ниже.

TextInputСобытие может уже быть помечено как обработанное внутренними реализациями составных элементов управления. Например, представляет собой TextBox составной элемент управления, в котором TextInput событие уже помечено как обработанное; в его композиции. Это делается потому, что элемент управления должен интерпретировать некоторые типы входных данных, например клавиши со стрелками, которые имеют специальное значение для этого элемента управления. Если вы используете PreviewTextInput в качестве события, когда вы подключаете обработчики для ввода текста, вы можете получить лучшие результаты. Этот метод обходит большинство случаев, когда композиция элементов управления уже пометила это событие как обработанное и не дает обработчику получать событие в маршруте события.

Это TextInput событие позволяет компоненту или приложению ожидать ввода текста независимым от устройства образом. Клавиатура является основным средством TextInput , но также может вызываться распознавание речи, рукописного текста и другие устройства ввода TextInput .

Из-за сочетаний клавиш — либо на клавиатуре по умолчанию, либо с помощью редакторов методов ввода. несколько ключевых событий могут вызывать только одно событие текстового ввода.

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

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

Поле идентификатора TextInputEvent
Стратегия маршрутизации Восходящей маршрутизации
Делегат TextCompositionEventHandler
  • Соответствующее событие туннелирования — PreviewTextInput .

  • Переопределение OnTextInput для реализации обработки класса для этого события в производных классах.

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