Edit

Share via


ButtonBase.OnMouseLeftButtonDown(MouseButtonEventArgs) Method

Definition

Provides class handling for the MouseLeftButtonDown routed event that occurs when the left mouse button is pressed while the mouse pointer is over this control.

protected:
 override void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected override void OnMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);
override this.OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Overrides Sub OnMouseLeftButtonDown (e As MouseButtonEventArgs)

Parameters

e
MouseButtonEventArgs

The event data.

Remarks

This implementation marks the MouseLeftButtonDown event as handled by setting the Handled property of the event data to true when ClickMode is not set to Hover. To respond to the MouseLeftButtonDown event, attach an event handler to the PreviewMouseLeftButtonDown event, or call AddHandler(RoutedEvent, Delegate, Boolean) with handledEventsToo set to true.

When ClickMode is set to Press, this method raises the Click event.

Notes to Inheritors

If you override OnMouseLeftButtonDown(MouseButtonEventArgs), always call the base implementation in your OnMouseLeftButtonDown(MouseButtonEventArgs) implementation. Failure to call the base implementation prevents base classes from handling the event with a class handler, which might change the run-time behavior of the final class. You can call the base implementation either before or after your special handling, depending on your requirements.

Applies to