ContentElement.OnPreviewTextInput(TextCompositionEventArgs) Метод

Определение

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

protected public:
 virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected internal 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 Friend Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)

Параметры

e
TextCompositionEventArgs

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

Комментарии

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

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

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

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

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