Questa documentazione è stata archiviata e non viene gestita.

Metodo UIElement.OnMouseLeftButtonDown

Aggiornamento: novembre 2007

Viene richiamato quando un evento indirizzato MouseLeftButtonDown non gestito viene generato in questo elemento. Implementare questo metodo per aggiungere la gestione di classi per questo evento.

Spazio dei nomi:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

protected virtual void OnMouseLeftButtonDown(
	MouseButtonEventArgs e
)
protected void OnMouseLeftButtonDown(
	MouseButtonEventArgs e
)
protected function OnMouseLeftButtonDown(
	e : MouseButtonEventArgs
)
Non è possibile utilizzare metodi in XAML.

Parametri

e
Tipo: System.Windows.Input.MouseButtonEventArgs

Classe MouseButtonEventArgs che contiene i dati dell'evento. Nei dati degli eventi è indicato che è stato premuto il pulsante sinistro del mouse.

Sembra che l'evento MouseLeftButtonDown percorra una route di bubbling mentre in realtà viene trasferito in modo indiretto. Mouse.MouseDown è l'evento sottostante indirizzato per bubbling e ogni UIElement lungo la route dell'evento utilizza un'identica gestione per generare l'evento indirizzato diretto MouseLeftButtonDown. Sebbene sia possibile contrassegnare l'evento MouseLeftButtonDown come gestito per gli scopi di questo elemento, lo stato gestito non viene trasmesso agli altri elementi lungo la route dell'evento. Potrebbe essere necessario, tuttavia, contrassegnare l'evento come gestito per evitare che vengano richiamati i gestori di istanze generici (quelli che non specificano handledEventsToo).

L'implementazione predefinita per la gestione generica di eventi del mouse in UIElement rimane in ascolto di Mouse.MouseDown e lo converte in un evento locale appropriato. Se si desidera eseguire l'override di questa logica, è necessario creare una classe derivata. Nel costruttore statico della classe derivata, registrare un gestore di classi alternativo per Mouse.MouseDown. Non è possibile modificare il comportamento di gestione del mouse di UIElement eseguendo l'override di OnMouseLeftButtonDown.

In alternativa è possibile eseguire l'override di questo metodo per modificare la gestione degli eventi per uno stato specifico del mouse. La scelta di chiamare l'implementazione di base dipende dallo scenario. La mancata chiamata della base disattiva la gestione di input predefinita per tale evento del mouse in classi predecessore che prevedono anche di richiamare OnMouseLeftButtonDown. È ad esempio possibile effettuare la derivazione da Button ed eseguire l'override di OnMouseLeftButtonDown nella classe derivata senza chiamare l'implementazione di base. Questo override, tuttavia, disattiva l'evento Click.

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: