UIElement.MouseLeftButtonDown Ereignis

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 UIElementin 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, mit der Option, Ereignisse zu behandeln, 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 MouseLeftButtonDown behandelt markieren, markieren Sie im wesentlichen Mouse.MouseDown behandelt für alle weiteren Listener entlang der Route und für 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. Dazu zählen möglicherweise von Klassen Handlern generierte Ereignisse wie z. b. MouseDoubleClick.This possibly includes class-handler generated events such as MouseDoubleClick.

Konzeptionell sollten Sie sich dieses Ereignis (und andere Maustasten Ereignisse auf UIElement) als Maus-"Dienst" vorstellen (mit der Dienst Definition, die von der Mouse-Klasse bereitgestellt wird).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 von Zuständen nicht standardmäßiger Schaltflächen, müssen Sie möglicherweise die APIs für die Mouse-Klasse anstelle der-UIElementverwenden.For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIs 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 liegende Mouse-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 beheben, das in den vorangehenden wichtigen Ereignissen und weiterhin MouseLeftButtonDown-Ereignissen für eine abgeleitete Klasse, die über eine Klassen Behandlung verfügt, mit einer der folgenden Lösungen behandelt wird: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:

  • Anfügen von Handlern für das PreviewMouseDown-Ereignis, 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 im Steuerelement, indem Sie AddHandler 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
  • Überschreiben Sie OnMouseLeftButtonDown, 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