UIElement3D.MouseLeftButtonDown Evento

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 questa Panoramica degli eventi indirizzati sembra seguire una route di bubbling tramite un albero degli elementi, è in realtà un evento indirizzato diretto che viene generato e rigenerato lungo l'albero degli elementi da ogni UIElement3D.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 UIElement3D.

Questo evento è uno dei numerosi eventi correlati che segnalano le specifiche dei pulsanti del mouse di un evento Mouse.MouseDown sottostante, ovvero un evento associato 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, è necessario aggiungere gestori di eventi specifici del pulsante del mouse chiamando AddHandlerin modo esplicito, 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. Se si contrassegna MouseLeftButtonDown gestita, si sta essenzialmente contrassegnando Mouse.MouseDown gestita per tutti gli altri listener lungo il percorso 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 gestore della classe, ad esempio MouseDoubleClick.This possibly includes class-handler generated events such as MouseDoubleClick.

Concettualmente, si pensi a questo evento (e ad altri eventi dei pulsanti del mouse su UIElement3D) di essere un "servizio" del mouse (con la definizione del servizio fornita dalla classe Mouse).Conceptually, think of this event (and other mouse-button events on UIElement3D) 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 le API nella classe Mouse piuttosto che in UIElement3D.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 UIElement3D.

Importante

La gestione delle classi spesso contrassegna l'evento Mouse Class 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 eventi MouseLeftButtonDown 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'evento PreviewMouseDown, 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 firma che consente ai gestori di restare in ascolto degli eventi anche se sono già contrassegnati come gestiti 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.

MouseLeftButtonDown è stato introdotto nella versione .NET Framework 3,5.MouseLeftButtonDown is introduced in the .NET Framework version 3.5. Per altre informazioni, vedere Versioni e dipendenze.For more information, see Versions and Dependencies.

Informazioni evento indirizzatoRouted Event Information

Campo identificatoreIdentifier field MouseLeftButtonDownEvent
Strategia di routingRouting strategy DirettoDirect
delegatoDelegate MouseButtonEventHandler
  • Eseguire l'override OnMouseLeftButtonDown 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