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