UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

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

protected:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected virtual void OnPreviewMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

Параметры

e

MouseButtonEventArgs

Объект класса MouseButtonEventArgs, содержащий данные о событии. В данных события сообщается о том, что была нажата левая кнопка мыши.

Комментарии

Событие PreviewMouseLeftButtonDown , как представляется, проходит по маршруту туннелирования, но на самом деле перемещается косвенным образом. Mouse.PreviewMouseDown — это базовое событие, которое маршрутизируется туннелем, и каждый из них UIElement использует одинаковую обработку для создания прямого перенаправленного события PreviewMouseLeftButtonDown. Хотя вы можете пометить PreviewMouseLeftButtonDown событие как обработанное для целей этого элемента, обработанное состояние не сохраняется в других элементах маршрута события. Однако может потребоваться пометить событие как обработанное, чтобы предотвратить вызов общих обработчиков экземпляров (не указанных handledEventsToo).

Реализация по умолчанию для общей обработки событий мыши в UIElement прослушивает Mouse.PreviewMouseDown и преобразует его в соответствующее локальное событие. Если вы хотите переопределить эту логику, необходимо создать производный класс. В статическом конструкторе производного класса зарегистрируйте альтернативный обработчик класса для Mouse.PreviewMouseDown. Вы не можете изменить поведение UIElement мыши, переопределив OnPreviewMouseLeftButtonDown.

Кроме того, этот метод можно переопределить, чтобы изменить обработку событий для определенного состояния мыши. Выбор вызова базовой реализации зависит от вашего сценария. Неисправный вызов base отключает обработку входных данных по умолчанию для этого события мыши в классах-предках, которые также должны вызывать OnPreviewMouseLeftButtonDown. Например, можно наследовать от Button и переопределить OnPreviewMouseLeftButtonDown в производном классе, не вызывая базовую реализацию. Однако это переопределение отключает Click событие.