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

Definizione

Si verifica alla pressione del pulsante sinistro del mouse quando il puntatore è posizionato sull'elemento.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 

Implementazioni

Commenti

Anche se l' evento indirizzato sembra seguire una route di bubbling tramite un albero degli UIElementelementi, si tratta in realtà di un evento indirizzato diretto che viene generato e rigenerato lungo l'albero degli elementi.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.

Questo evento è uno dei numerosi eventi correlati che segnalano le specifiche dei pulsanti del mouse di un Mouse.MouseDown evento sottostante, ovvero un evento associato che viene elaborato da ogni elemento lungo una route dell'evento.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.

I dati dell'evento di questo evento espongono i dati dell'evento Mouse.MouseDown sottostante.The event data of this event exposes the event data of the underlying Mouse.MouseDown event. Se l'evento è contrassegnato come gestito lungo la route dell'evento, vengono comunque generati gli eventi specifici del pulsante del mouse; Tuttavia, i gestori degli eventi specifici del pulsante del mouse devono essere aggiunti chiamando AddHandlerin modo esplicito, con l'opzione per gestire gli eventi che sono già contrassegnati come gestiti, per essere listener dell'evento.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. Se si contrassegna MouseLeftButtonDown come gestita, il contrassegno viene Mouse.MouseDown essenzialmente gestito per tutti gli altri listener lungo la route e per tutti gli eventi correlati.If you mark MouseLeftButtonDown handled, you are essentially marking Mouse.MouseDown handled for all further listeners along the route, and on all related events. Questo può includere eventi generati dal MouseDoubleClickgestore della classe, ad esempio.This possibly includes class-handler generated events such as MouseDoubleClick.

Concettualmente, si pensi a questo evento (e ad altri eventi del pulsante UIElementdel mouse su) di essere un "servizio" del mouse (con la definizione Mouse del servizio fornita dalla classe).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). L'evento aggiunge la comodità di non dover controllare gli Stati dei pulsanti del mouse (Left-Right, Down) degli eventi del mouse originali nei dati dell'evento.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. Per gli scenari più avanzati, ad esempio il controllo degli Stati dei pulsanti non standard, potrebbe essere necessario usare APIAPIs Mouse nella classe anziché in quelli presenti in UIElement.For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIAPIs on the Mouse class rather than those on UIElement.

Importante

Alcune classi di controlli possono avere una gestione delle classi intrinseca per gli eventi dei pulsanti del mouse.Some control classes might have inherent class handling for mouse button events. L'evento di selezione del pulsante sinistro del mouse è l'evento più probabile che contenga la gestione delle classi in un controllo.The left mouse button down event is the most likely event to have class handling in a control. La gestione delle classi spesso contrassegna l' Mouse evento della classe sottostante come gestito.The class handling often marks the underlying Mouse class event as handled. Una volta che l'evento è stato contrassegnato come gestito, gli altri gestori di istanze collegati a tale elemento non vengono in genere generati.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Anche tutti gli altri gestori di istanza o di classe collegati agli elementi nella direzione di bubbling verso la radice nell'albero dell'interfaccia utente non vengono generati normalmente.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.

È possibile risolvere il problema descritto nell'elemento importante precedente e continuare a ricevere MouseLeftButtonDown gli eventi per gli eventi di un pulsante sinistro del mouse su una classe derivata con gestione delle classi utilizzando una di queste soluzioni: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:

  • Connetti gestori per l' PreviewMouseDown evento, che non è contrassegnato come gestito dai controlli.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Si noti che poiché si tratta di un evento di anteprima, la route inizia dalla radice e ne effettua il tunneling fino al controllo.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Registrare un gestore sul controllo in modo procedurale chiamando AddHandler e scegliendo l'opzione Signature che consente ai gestori di restare in ascolto degli eventi anche se sono già contrassegnati come gestiti nei dati degli eventi indirizzati.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.

Informazioni evento indirizzatoRouted Event Information

Campo identificatoreIdentifier field MouseLeftButtonDownEvent
Strategia di routingRouting strategy DirectDirect
delegatoDelegate MouseButtonEventHandler
  • Eseguire OnMouseLeftButtonDown l'override di per implementare la gestione delle classi per questo evento nelle classi derivate.Override OnMouseLeftButtonDown to implement class handling for this event in derived classes.

Si applica a

Vedi anche