UIElement.PreviewMouseLeftButtonDown Событие

Определение

Происходит при нажатии левой кнопки мыши в тот момент, когда указатель мыши находится над данным элементом.

public:
 virtual event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseLeftButtonDown;
member this.PreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event PreviewMouseLeftButtonDown As MouseButtonEventHandler 

Тип события

Реализации

Комментарии

Хотя это перенаправленное событие , кажется, следует по маршруту туннелирования через дерево элементов, на самом деле это прямое перенаправленное событие, которое вызывается и повторно выполняется вдоль дерева элементов каждым UIElementэлементом .

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

Данные события этого события предоставляют данные события базового Mouse.PreviewMouseDown события. Если это событие помечается как обработанное по маршруту события, события, относящиеся к кнопке мыши, по-прежнему вызываются; однако обработчики событий, относящихся к кнопке мыши, должны быть добавлены путем явного вызова AddHandlerс параметром для обработки событий, которые уже помечены как обработанные, чтобы быть прослушивателями события. Если вы помечаете PreviewMouseLeftButtonDown обработано, вы помечаете Mouse.PreviewMouseDown обработку для всех дальнейших прослушивателей по маршруту, а также для всех связанных событий. Сюда могут быть включены события, созданные обработчиком классов, такие как PreviewMouseDoubleClick.

Концептуально это событие (и другие события кнопки мыши в UIElement) считаются "службой" мыши (с определением службы, предоставленным классом Mouse ). Это событие позволяет не проверка состояния кнопки мыши (слева вправо, вверх и вниз) исходных событий мыши в данных события. Для более сложных сценариев, таких как проверка состояния нестандартных кнопок, может потребоваться использовать API в Mouse классе, а не в UIElement.

Сведения о маршрутизируемом событии

Поле идентификатора PreviewMouseLeftButtonDownEvent
Стратегия маршрутизации Прямой доступ
Делегат MouseButtonEventHandler
  • Переопределите OnPreviewMouseLeftButtonDown , чтобы реализовать обработку классов для этого события в производных классах.

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

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