ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Метод

Определение

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

System.Windows

Сборка:

PresentationCore.dll

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

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

protected internal 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 Friend Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

Параметры

e

MouseButtonEventArgs

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

Комментарии

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

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

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