UIElement.OnMouseLeftButtonDown(MouseButtonEventArgs) Methode

Definition

Wird aufgerufen, wenn ein nicht behandeltes geroutetes MouseLeftButtonDown-Ereignis für dieses Element ausgelöst wird.Invoked when an unhandled MouseLeftButtonDown routed event is raised on this element. Implementieren Sie diese Methode, um eine Klassenbehandlung für dieses Ereignis hinzuzufügen.Implement this method to add class handling for this event.

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

Parameter

e
MouseButtonEventArgs

Das MouseButtonEventArgs, das die Ereignisdaten enthält.The MouseButtonEventArgs that contains the event data. Die Ereignisdaten melden, dass die linke Maustaste gedrückt wurde.The event data reports that the left mouse button was pressed.

Hinweise

Das MouseLeftButtonDown Ereignis scheint eine bubblingerroute zu reisen, aber es erfolgt indirekt auf indirekte Weise.The MouseLeftButtonDown event appears to travel a bubbling route but actually travels in an indirect way. Mouse.MouseDown ist das zugrunde liegende Ereignis, das Blasen geroutet ist, und jede UIElement entlang der Ereignis Route verwendet identische Behandlung, um das direkte Routing Ereignis MouseLeftButtonDownzu erhöhen.Mouse.MouseDown is the underlying event that is bubble routed, and each UIElement along the event route uses identical handling to raise the direct routed event MouseLeftButtonDown. Obwohl Sie das MouseLeftButtonDown Ereignis für die Zwecke dieses Elements als behandelt markieren können, wird der behandelte Zustand nicht an andere Elemente auf der Ereignis Route weitergeleitet.Although you can mark the MouseLeftButtonDown event as handled for purposes of this element, the handled state does not perpetuate to other elements along the event route. Möglicherweise möchten Sie jedoch das Ereignis als behandelt markieren, um zu verhindern, dass allgemeine Instanzhandler (die keine handledEventsToo) aufgerufen werden.However, you might want to mark the event as handled in order to prevent general instance handlers (those that did not specify handledEventsToo) from being invoked.

Die Standard Implementierung für die Behandlung allgemeiner Mausereignisse in UIElement lauscht auf Mouse.MouseDown und konvertiert sie in ein entsprechendes lokales Ereignis.The default implementation for general mouse event handling in UIElement listens for Mouse.MouseDown and converts it to an appropriate local event. Wenn Sie diese Logik außer Kraft setzen möchten, müssen Sie eine abgeleitete Klasse erstellen.If you want to override this logic, you must create a derived class. Registrieren Sie im statischen Konstruktor ihrer abgeleiteten Klasse einen alternativen Klassen Handler für Mouse.MouseDown.In the static constructor of your derived class, register an alternative class handler for Mouse.MouseDown. Sie können das Verhalten der Maus Behandlung von UIElement nicht ändern, indem Sie OnMouseLeftButtonDownaußer Kraft setzen.You cannot change the mouse handling behavior of UIElement by overriding OnMouseLeftButtonDown.

Alternativ können Sie diese Methode überschreiben, um die Ereignis Behandlung für einen bestimmten Maus Zustand zu ändern.Alternatively, you can override this method in order to change event handling for a specific mouse state. Ob Sie die Basis Implementierung aufzurufen, hängt von Ihrem Szenario ab.Whether you choose to call the base implementation depends on your scenario. Wenn Sie die Basis nicht aufrufen, wird die Standardeingabe Behandlung für dieses Maus Ereignis für Vorgänger Klassen deaktiviert, die ebenfalls OnMouseLeftButtonDownaufrufen.Failing to call base disables default input handling for that mouse event on ancestor classes that also expect to invoke OnMouseLeftButtonDown. Beispielsweise können Sie von Button ableiten und OnMouseLeftButtonDown in der abgeleiteten Klasse überschreiben, ohne die Basis Implementierung aufrufen zu müssen. Diese außer Kraft Setzung deaktiviert jedoch das Click-Ereignis.For example, you can derive from Button and override OnMouseLeftButtonDown in your derived class without calling the base implementation; however, this override disables the Click event.

Gilt für: