UIElement.OnPreviewMouseMove(MouseEventArgs) UIElement.OnPreviewMouseMove(MouseEventArgs) UIElement.OnPreviewMouseMove(MouseEventArgs) UIElement.OnPreviewMouseMove(MouseEventArgs) Method

Определение

Вызывается, когда необработанное присоединенное событие PreviewMouseMove встречает на своем маршруте элемент, производный от этого класса.Invoked when an unhandled PreviewMouseMove attached event reaches an element in its route that is derived from this class. Реализуйте этот метод, чтобы добавить для класса обработчик данного события.Implement this method to add class handling for this event.

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

Параметры

e
MouseEventArgs MouseEventArgs MouseEventArgs MouseEventArgs

Объект класса MouseEventArgs, содержащий данные о событии.The MouseEventArgs that contains the event data.

Комментарии

Этот метод не имеет реализации по умолчанию.This method has no default implementation. Поскольку промежуточный класс в наследовании может реализовать этот метод, рекомендуется вызвать базовую реализацию в реализации.Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

Назначение этого метода аналогично среда CLRcommon language runtime (CLR) шаблону событий для методов *: Этот метод предоставляет средства для обработки соответствующего события из производных классов путем установки обработчика класса вместо обработчика экземпляра.The purpose of this method is similar to the среда CLRcommon language runtime (CLR) event pattern On* methods: this method provides the means to handle the matching event from derived classes by establishing a class handler instead of an instance handler. В этом случае сопоставленное событие является перенаправленным событием.In this case the matching event is a routed event. Шаблон реализации методов On * отличается для перенаправленных событий, так как перенаправленное событие может быть вызвано дочерним элементом, который не обязательно должен вызывать обработчики.The implementation pattern of the On* methods is different for routed events because a routed event can be raised by a child element, which is not necessarily the element that will invoke handlers. Поэтому в реализации необходимо изучить свойства источника данных события.Therefore, your implementation needs to examine the source properties of the event data. В большинстве случаев не следует пытаться повторно вызывать событие.It should not try to reraise the event in most cases.

Переопределяя этот метод или зарегистрировав обработчики класса с RegisterClassHandlerпомощью, производные UIElement классы могут вызывать закрытые методы обработчика класса, если событие получено в маршруте события.Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of UIElement can call private class handler methods when the event is received along the event route. Одним из сценариев, где требуется обработка класса, является управление данными события и пометка перенаправленного события как обработанного.One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled. Другой сценарий, специально предназначенный для событий предварительного просмотра, заключается в том, чтобы пометить их как обработанные, чтобы соответствующие обработчики класса восходящей маршрутизации не вызывались.Another scenario that is specifically for Preview events is to mark them handled so that the matching bubbling class handlers are not invoked.

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

Дополнительно