Поделиться через


UIElement.OnPreviewTextInput(TextCompositionEventArgs) Метод

Определение

Вызывается, когда необработанное вложенное событие PreviewTextInput встречает на своем маршруте элемент, производный от этого класса. Реализуйте этот метод, чтобы добавить для класса обработчик данного события.

protected:
 virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected virtual void OnPreviewTextInput (System.Windows.Input.TextCompositionEventArgs e);
abstract member OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
Protected Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)

Параметры

e
TextCompositionEventArgs

Объект класса TextCompositionEventArgs, содержащий данные о событии.

Комментарии

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

Назначение этого метода аналогично шаблону событий среды CLR в методах On*: этот метод предоставляет средства для обработки события сопоставления из производных классов путем создания обработчика класса вместо обработчика экземпляра. В этом случае событие сопоставления является перенаправленным событием. Шаблон реализации методов On* отличается для перенаправленных событий, так как перенаправленное событие может быть вызвано дочерним элементом, который не обязательно является элементом, который будет вызывать обработчики. Поэтому реализация должна изучить исходные свойства данных события. В большинстве случаев не следует пытаться повторить событие.

Переопределяя этот метод или регистрируя обработчики классов в RegisterClassHandler, производные классы UIElement могут вызывать методы обработчика закрытых классов при получении события по маршруту события. Одним из сценариев, в котором подходит обработка класса, является обработка данных события и пометка перенаправленного события как обработанного. Другой сценарий, который предназначен специально для событий предварительного просмотра, — пометить их как обработанные, чтобы не вызывать соответствующие обработчики восходящего класса.

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

См. также раздел