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 

Тип события

Реализации

Комментарии

Важно!

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

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

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

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

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

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

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

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

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