Freigeben über


UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Methode

Definition

Wird aufgerufen, wenn ein nicht behandeltes PreviewMouseLeftButtonDown-Routingereignis beim Durchlauf ein von dieser Klasse abgeleitetes Element erreicht. Implementieren Sie diese Methode, um eine Klassenbehandlung für dieses Ereignis hinzuzufügen.

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)

Parameter

e
MouseButtonEventArgs

Das MouseButtonEventArgs, das die Ereignisdaten enthält. Die Ereignisdaten melden, dass die linke Maustaste gedrückt wurde.

Hinweise

Das PreviewMouseLeftButtonDown Ereignis scheint eine Tunnelroute zu fahren, aber tatsächlich auf indirekte Weise. Mouse.PreviewMouseDown ist das zugrunde liegende Ereignis, das tunnelgeleitet wird, und jedes UIElement entlang der Ereignisroute verwendet die identische Behandlung, um das direkte Routingereignis PreviewMouseLeftButtonDownauszulösen. Obwohl Sie das PreviewMouseLeftButtonDown Ereignis als für die Zwecke dieses Elements als behandelt markieren können, wird der behandelte Zustand nicht für andere Elemente entlang der Ereignisroute beibehalten. Möglicherweise möchten Sie das Ereignis jedoch als behandelt markieren, um zu verhindern, dass allgemeine instance Handler (die nicht angegeben handledEventsToohaben) aufgerufen werden.

Die Standardimplementierung für die allgemeine Mausereignisbehandlung in UIElement lauscht Mouse.PreviewMouseDown auf ein geeignetes lokales Ereignis und konvertiert es. Wenn Sie diese Logik überschreiben möchten, müssen Sie eine abgeleitete Klasse erstellen. Registrieren Sie im statischen Konstruktor Ihrer abgeleiteten Klasse einen alternativen Klassenhandler für Mouse.PreviewMouseDown. Sie können das Maushandlingsverhalten von UIElement nicht ändern, indem Sie überschreiben OnPreviewMouseLeftButtonDown.

Alternativ können Sie diese Methode überschreiben, um die Ereignisbehandlung für einen bestimmten Mauszustand zu ändern. Ob Sie die Basisimplementierung aufrufen, hängt von Ihrem Szenario ab. Wenn die Basis nicht aufgerufen wird, wird die Standardeingabebehandlung für dieses Mausereignis in Vorgängerklassen deaktiviert, die ebenfalls den Aufruf OnPreviewMouseLeftButtonDownvon erwarten. Sie können beispielsweise von Button abgeleitet und in Ihrer abgeleiteten Klasse außer Kraft OnPreviewMouseLeftButtonDown setzen, ohne die Basisimplementierung aufzurufen. Durch diese Außerkraftsetzung wird das Click Ereignis jedoch deaktiviert.

Gilt für: