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 dies Routingereignis bubbling-Route durch eine Elementstruktur folgen scheint es ist tatsächlich eine direkte Routingereignis, das ausgelöst wird, und die Elementstruktur von jedem erneut UIElement.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 Schaltflächen Einzelheiten einer zugrunde liegenden Berichten Mouse.MouseDown -Ereignis, das ein angefügtes Ereignis handelt, die von jedem Element auf einer Ereignisroute 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 für dieses Ereignis verfügbar macht, die Daten der zugrunde liegenden Mouse.MouseDown Ereignis.The event data of this event exposes the event data of the underlying Mouse.MouseDown event. Wenn das Ereignis als behandelt, auf der Ereignisroute markiert ist, werden die spezifischen Ereignisse für Schaltflächen weiterhin ausgelöst wird. Handler für die bestimmte Ereignisse für Schaltflächen müssen jedoch durch explizites Aufrufen hinzugefügt werden AddHandler, mit der Option zum Behandeln von Ereignissen, die bereits als behandelt markiert werden, um Listener das Ereignis verwendet werden.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 kennzeichnen MouseLeftButtonDown behandelt, Sie sind im Wesentlichen markieren Mouse.MouseDown für alle weiteren Listener entlang der Route als behandelt und für alle Ereignisse im Zusammenhang.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 Klassenhandler generierte Ereignisse wie z. B. MouseDoubleClick.This possibly includes class-handler generated events such as MouseDoubleClick.

Betrachten Sie dieses Ereignis vom Konzept her (und andere Ereignisse der Schaltflächen auf UIElement) eine Maus "Service" sein (mit der Definition des Diensts bereitgestellt werden, indem der Mouse Klasse).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 wird hinzugefügt, die Vorteile ohne überprüfen Sie die Maus Schaltflächenstatus (links nach rechts, nach oben und unten) von den Mausereignissen ursprünglichen in den Ereignisdaten.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 einige erweiterte Szenarien, z. B. das Überprüfen von Zuständen, der nicht standardmäßige Schaltflächen, müssen Sie möglicherweise verwenden die APIsAPIs auf die Mouse -Klasse anstelle der für UIElement.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 Steuerelementklassen möglicherweise inhärente Klassenbehandlung für Mausereignisse-Schaltfläche.Some control classes might have inherent class handling for mouse button events. Die linke Maustaste ausgelöste Ereignis ist das wahrscheinlichste Ereignis um eine Klassenbehandlung in einem Steuerelement zu erhalten.The left mouse button down event is the most likely event to have class handling in a control. Die Klassenbehandlung häufig kennzeichnet das zugrunde liegende Mouse Klassenereignis als behandelt.The class handling often marks the underlying Mouse class event as handled. Sobald das Ereignis als behandelt markiert ist, werden andere instanzhandlern, die auf das betreffende Element angefügt sind nicht normalerweise ausgelöst.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Keine andere Klasse oder Instanz Handler, die auf Elemente in der bubbling-Richtung zum Stamm in der Benutzeroberflächenautomatisierungs-Struktur angefügt sind, werden Regel 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.

Können Sie beheben Sie das Problem, die in den vorherigen wichtigen beschrieben wird und trotzdem erhalten MouseLeftButtonDown Ereignisse für die linke Maustaste gedrückt down-Ereignissen in einer abgeleiteten Klasse, die Klassenbehandlung mithilfe einer der folgenden Lösungen: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 die PreviewMouseDown -Ereignis, das nicht von den Steuerelementen als behandelt markiert ist.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Beachten Sie, da dies ein Vorschauereignis ist, wird die Route am Stamm beginnt und auf das Steuerelement Tunnel.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 durch Aufrufen von Prozedural AddHandler und Auswählen der Option für die Signatur, die es ermöglicht Handlern für Ereignisse zu lauschen, auch wenn sie bereits in die Routingereignisdaten 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

Feld "ID"Identifier field MouseLeftButtonDownEvent
Routing-StrategieRouting strategy DirektDirect
delegateDelegate MouseButtonEventHandler
  • Außer Kraft setzen OnMouseLeftButtonDown um eine Klassenbehandlung 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