UIElement.TextInput UIElement.TextInput UIElement.TextInput UIElement.TextInput Event

Определение

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

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