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 -> unitProtected Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)Параметры
Объект класса TextCompositionEventArgs, содержащий данные о событии.
Комментарии
Этот метод не имеет реализации по умолчанию. Так как промежуточный класс в наследовании может реализовать этот метод, рекомендуется вызывать базовую реализацию в реализации.
Назначение этого метода аналогично шаблону событий среды CLR в методах On*: этот метод предоставляет средства для обработки события сопоставления из производных классов путем создания обработчика класса вместо обработчика экземпляра. В этом случае событие сопоставления является перенаправленным событием. Шаблон реализации методов On* отличается для перенаправленных событий, так как перенаправленное событие может быть вызвано дочерним элементом, который не обязательно является элементом, который будет вызывать обработчики. Поэтому реализация должна изучить исходные свойства данных события. В большинстве случаев не следует пытаться повторить событие.
Переопределяя этот метод или регистрируя обработчики классов в RegisterClassHandler, производные классы UIElement могут вызывать методы обработчика закрытых классов при получении события по маршруту события. Одним из сценариев, в котором подходит обработка класса, является обработка данных события и пометка перенаправленного события как обработанного. Другой сценарий, который предназначен специально для событий предварительного просмотра, — пометить их как обработанные, чтобы не вызывать соответствующие обработчики восходящего класса.
