UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown Event

Definition

Tritt auf, wenn die linke Maustaste gedrückt wird, während sich der Mauszeiger über diesem Element befindet.Occurs when the left mouse button is pressed while the mouse pointer is over this element.

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

Implementiert

Hinweise

Obwohl dieses Routing Ereignis einer bubblingerroute durch eine Elementstruktur folgt, ist es tatsächlich ein direktes Routing Ereignis, das von jedem UIElementElement in der Elementstruktur ausgelöst und erneut ausgeführt wird.Although this routed event seems to follow a bubbling route through an element tree, it actually is a direct routed event that is raised and reraised along the element tree by each UIElement.

Dieses Ereignis ist eines von mehreren verwandten Ereignissen, die die Mauszeiger Details eines zugrunde liegenden Mouse.MouseDown Ereignisses melden, bei dem es sich um ein angefügtes Ereignis handelt, das von jedem Element entlang einer Ereignis Route verarbeitet wird.This event is one of several related events that report the mouse-button specifics of an underlying Mouse.MouseDown event, which is an attached event that is processed by each element along an event route.

Die Ereignisdaten dieses Ereignisses machen die Ereignisdaten des zugrunde liegenden Mouse.MouseDown Ereignisses verfügbar.The event data of this event exposes the event data of the underlying Mouse.MouseDown event. Wenn dieses Ereignis auf der Ereignis Route als behandelt markiert ist, werden die Mauszeiger-spezifischen Ereignisse immer noch ausgelöst. Allerdings müssen Handler für die Mauszeiger-spezifischen Ereignisse hinzugefügt werden, indem explizit AddHandleraufgerufen wird, wobei Ereignisse behandelt werden, die bereits als behandelt markiert sind, um Listener für das-Ereignis zu sein.If that event is marked as handled along the event route, the mouse-button specific events are still raised; however, handlers of the mouse-button specific events must be added by explicitly calling AddHandler, with the option to handle events that are already marked as handled, in order to be listeners to the event. Wenn Sie behandelt MouseLeftButtonDown markieren, markieren Mouse.MouseDown Sie im Grunde alle weiteren Listener entlang der Route und alle zugehörigen Ereignisse.If you mark MouseLeftButtonDown handled, you are essentially marking Mouse.MouseDown handled for all further listeners along the route, and on all related events. Dies schließt möglicherweise Klassen Handler-generierte Ereignisse ein MouseDoubleClick, z. b.This possibly includes class-handler generated events such as MouseDoubleClick.

Konzeptionell sollten Sie sich dieses Ereignis (und andere Maustasten Ereignisse UIElement) als Maus-"Dienst" (mit der von der Mouse -Klasse bereitgestellten Dienst Definition) vorstellen.Conceptually, think of this event (and other mouse-button events on UIElement) to be a mouse "service" (with the service definition provided by the Mouse class). Das Ereignis fügt die Möglichkeit hinzu, nicht die Mauszeiger Zustände (von links nach rechts, nach oben nach unten) der ursprünglichen Mausereignisse in den Ereignisdaten überprüfen zu müssen.The event adds the convenience of not needing to check the mouse button states (left-right, up-down) of the original mouse events in the event data. Für erweiterte Szenarien, wie z. b. das Überprüfen auf Zustände von nicht standardmäßigen Schaltflächen, müssen APIsAPIs Sie möglich Mouse erweise auf der-Klasse UIElementanstelle der in der-Klasse verwenden.For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIsAPIs on the Mouse class rather than those on UIElement.

Wichtig

Einige Steuerelement Klassen verfügen möglicherweise über eine inhärente Klassen Behandlung für Maustasten Ereignisse.Some control classes might have inherent class handling for mouse button events. Das Ereignis mit der linken Maustaste auf das Ereignis ist das wahrscheinlichste Ereignis, um eine Klassen Behandlung in einem-Steuerelement zu erhalten.The left mouse button down event is the most likely event to have class handling in a control. Die Klassen Behandlung markiert häufig das zugrunde Mouse liegende Klassen Ereignis als behandelt.The class handling often marks the underlying Mouse class event as handled. Wenn das Ereignis als behandelt markiert ist, werden andere Instanzhandler, die diesem Element zugeordnet sind, normalerweise nicht ausgelöst.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Alle anderen Klassen-oder Instanzhandler, die an Elemente in der Blasen Richtung an den Stamm in der UI-Struktur angefügt werden, werden normalerweise nicht ausgelöst.Any other class or instance handlers that are attached to elements in the bubbling direction towards the root in the UI tree are also not ordinarily raised.

Sie können das Problem, das in den vorangehenden Ereignissen "wichtig" und MouseLeftButtonDown "empfangen" angezeigt wird, auf eine abgeleitete Klasse, die über eine Klassen Behandlung verfügt, mit einer der folgenden Lösungen beheben:You can resolve the issue that is outlined in the preceding Important and still receive MouseLeftButtonDown events for left mouse button down events on a derived class that has class handling by using either of these solutions:

  • Fügen Sie Handler für das PreviewMouseDown -Ereignis an, das von den-Steuerelementen nicht als behandelt markiert ist.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Da es sich hierbei um ein Vorschau Ereignis handelt, beginnt die Route im Stammverzeichnis und wird zum-Steuerelement.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Registrieren Sie einen Handler für das Steuerelement, indem AddHandler Sie aufrufen und die Signatur Option auswählen, mit der Handler Ereignisse überwachen können, auch wenn Sie in den Routing Ereignisdaten bereits als behandelt markiert sind.Register a handler on the control procedurally by calling AddHandler and choosing the signature option that enables handlers to listen for events even if they are already marked as handled in the routed event data.

Informationen zum RoutingereignisRouted Event Information

BezeichnerfeldIdentifier field MouseLeftButtonDownEvent
Routing StrategieRouting strategy DirektDirect
delegateDelegate MouseButtonEventHandler
  • Über OnMouseLeftButtonDown schreiben, um die Klassen Behandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.Override OnMouseLeftButtonDown to implement class handling for this event in derived classes.

Gilt für:

Siehe auch