ContentElement.MouseLeftButtonDown ContentElement.MouseLeftButtonDown ContentElement.MouseLeftButtonDown ContentElement.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 ciò Cenni preliminari sugli eventi indirizzati sembra seguono una route di bubbling attraverso un albero degli elementi, in realtà è un evento indirizzato diretto che viene generato e rigenerato l'albero degli elementi da ogni ContentElement.Although this Routed Events Overview 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 ContentElement.

Questo evento è uno dei numerosi eventi correlati che indicano le specifiche del pulsante del mouse di un oggetto sottostante Mouse.MouseDown evento, vale a dire un evento associato che viene elaborato da ogni elemento lungo la route di un 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.

Gli argomenti dell'evento espongono gli elementi dell'oggetto sottostante Mouse.MouseDown evento.The arguments of this event expose the arguments of the underlying Mouse.MouseDown event. Se tale evento è contrassegnato come gestito lungo la route dell'evento, vengono comunque generati eventi specifici del pulsante del mouse. Tuttavia, è necessario aggiungere i gestori di eventi specifici del pulsante del mouse in modo esplicito chiamando AddHandler, con l'opzione per gestire gli eventi che sono già contrassegnati come gestiti, in modo da essere listener per l'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.

Pensare a livello concettuale, questo evento (e altri eventi del pulsante del mouse su ContentElement) da un mouse "servizio" (con la definizione del servizio fornita dal Mouse classe).Conceptually, think of this event (and other mouse-button events on ContentElement) 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 del pulsante del mouse (da sinistra a destra, giù) degli eventi del mouse originale 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 scenari più avanzati, ad esempio la verifica degli stati dei pulsanti non standard, potrebbe essere necessario usare il APIAPIs nella Mouse classe anziché quelli su ContentElement.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 ContentElement.

Importante

Alcuni ContentElement le classi derivate che hanno un comportamento simile al controllo, ad esempio, Hyperlink, potrebbe essere intrinseca gestione delle classi per gli eventi del pulsante del mouse.A few ContentElement derived classes that have control-like behavior, for example, Hyperlink, might have inherent class handling for mouse button events. Il pulsante sinistro del mouse evento di selezione è l'evento più probabile per avere in un controllo di gestione delle classi.The left mouse button down event is the most likely event to have class handling in a control. La classe gestisce spesso contrassegna sottostante Mouse classe di evento come gestito.The class handling often marks the underlying Mouse class event as handled. Dopo l'evento è contrassegnato come gestito, altri gestori istanze collegati a tale elemento non vengono generati normalmente.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Inoltre non in genere vengono generati tutti gli altri gestori di classe o istanza che sono collegati agli elementi nella direzione bubbling verso la radice dell'albero dell'interfaccia utente.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 nella nota Importante precedente e continuare a ricevere MouseLeftButtonDown gli eventi per gli eventi in una classe derivata che ha usando una di queste soluzioni di gestione delle classi di selezione del pulsante sinistro del mouse: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:

  • Collegare i gestori per il 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 alla radice e giunge 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 del controllo a livello di routine chiamando AddHandler e scegliendo l'opzione di firma che consente ai gestori in ascolto di eventi, anche se sono già contrassegnati come gestito nei dati dell'evento indirizzato.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 dell'identificatoreIdentifier field MouseLeftButtonDownEvent
Strategia di routingRouting strategy DirectDirect
delegatoDelegate MouseButtonEventHandler
  • Eseguire l'override OnMouseLeftButtonDown per implementare la gestione di questo evento nelle classi derivate della classe.Override OnMouseLeftButtonDown to implement class handling for this event in derived classes.

Si applica a

Vedi anche