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