UIElement.MouseLeftButtonDown Evento

Definizione

Si verifica alla pressione del pulsante sinistro del mouse quando il puntatore è posizionato sull'elemento.

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 

Tipo evento

Implementazioni

Commenti

Anche se questo evento indirizzato sembra seguire una route di bubbling attraverso un albero degli elementi, in realtà è un evento indirizzato diretto generato e generato lungo l'albero degli elementi da ogni UIElement.

Questo evento è uno dei diversi eventi correlati che segnalano le specifiche del pulsante del mouse di un evento sottostante Mouse.MouseDown , ovvero un evento associato elaborato da ogni elemento lungo una route di eventi.

I dati dell'evento di questo evento espongono i dati dell'evento sottostante Mouse.MouseDown . Se tale evento viene contrassegnato come gestito lungo la route dell'evento, gli eventi specifici del pulsante del mouse vengono comunque generati; Tuttavia, i gestori degli eventi specifici del pulsante del mouse devono essere aggiunti chiamando AddHandlerin modo esplicito , con l'opzione per gestire gli eventi già contrassegnati come gestiti, in modo da essere listener per l'evento. Se si contrassegna MouseLeftButtonDown la gestione, si contrassegna Mouse.MouseDown essenzialmente la gestione per tutti gli altri listener lungo la route e su tutti gli eventi correlati. Questo può includere eventi generati dal gestore di classi, MouseDoubleClickad esempio .

Concettualmente, si pensi a questo evento (e ad altri eventi del pulsante del mouse su UIElement) come "servizio" del mouse (con la definizione del servizio fornita dalla Mouse classe ). L'evento aggiunge la praticità di non dover controllare gli stati del pulsante del mouse (a sinistra, verso il basso) degli eventi del mouse originali nei dati dell'evento. Per scenari più avanzati, ad esempio il controllo degli stati dei pulsanti non standard, potrebbe essere necessario usare le API nella Mouse classe anziché quelle in UIElement.

Importante

Alcune classi di controllo potrebbero avere una gestione intrinseca della classe per gli eventi del pulsante del mouse. L'evento sinistro del pulsante del mouse verso il basso è l'evento più probabile che abbia la gestione delle classi in un controllo . La gestione della classe contrassegna spesso l'evento della classe sottostante Mouse come gestito. Dopo che l'evento è contrassegnato come gestito, gli altri gestori di istanza associati a tale elemento non vengono normalmente generati. Anche qualsiasi altro gestore di classe o istanza collegato agli elementi nella direzione di bubbling verso la radice nell'albero dell'interfaccia utente non viene in genere generato.

È possibile risolvere il problema descritto nell'argomento Importante precedente e ricevere MouseLeftButtonDown comunque eventi per gli eventi del pulsante sinistro del mouse verso il basso in una classe derivata con gestione delle classi usando una di queste soluzioni:

  • Collegare gestori per l'evento PreviewMouseDown , che non è contrassegnato come gestito dai controlli. Si noti che, poiché si tratta di un evento di anteprima, la route inizia alla radice e esegue il tunneling fino al controllo.

  • Registrare un gestore nel controllo in modo procedurale chiamando AddHandler e scegliendo l'opzione di firma che consente ai gestori di restare in ascolto degli eventi anche se sono già contrassegnati come gestiti nei dati dell'evento indirizzato.

Informazioni evento indirizzato

Campo Identificatore MouseLeftButtonDownEvent
Strategia di routing Connessione diretta
Delegato MouseButtonEventHandler
  • Eseguire l'override per implementare OnMouseLeftButtonDown la gestione delle classi per questo evento nelle classi derivate.

Si applica a

Vedi anche