ContentElement.OnPreviewKeyDown(KeyEventArgs) Метод

Определение

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

protected public:
 virtual void OnPreviewKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected internal virtual void OnPreviewKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Friend Overridable Sub OnPreviewKeyDown (e As KeyEventArgs)

Параметры

e
KeyEventArgs

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

Комментарии

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

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

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

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

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