UIElement3D.OnPreviewMouseDown(MouseButtonEventArgs) Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Viene richiamato ogni volta che un evento indirizzato associato PreviewMouseDown non gestito raggiunge un elemento nella propria route derivato da questa classe. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.

protected public:
 virtual void OnPreviewMouseDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected internal virtual void OnPreviewMouseDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnPreviewMouseDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Friend Overridable Sub OnPreviewMouseDown (e As MouseButtonEventArgs)

Parametri

e

MouseButtonEventArgs

Oggetto MouseButtonEventArgs che contiene i dati dell'evento. I dati dell'evento indicano che sono stati premuti uno o più pulsanti del mouse.

Commenti

Le azioni del pulsante del mouse vengono gestite anche da un gestore di input dedicato. Altre funzionalità di programmazione che si basano su azioni del pulsante del mouse, ad esempio associazioni di input e comando, possono richiamare gestori per l'azione prima di essere esposti come azione generale del pulsante del mouse. Se queste funzionalità di sistema di input contrassegnano l'evento Mouse.PreviewMouseDown come gestito, OnPreviewMouseDown non viene richiamato.

Se si usa questo gestore di classi per contrassegnare l'evento come gestito, è possibile influire sugli eventi seguenti: PreviewMouseLeftButtonDown e PreviewMouseRightButtonDown. Uno di questi eventi può essere generato sull'elemento di ricezione quando Mouse.PreviewMouseDown viene ricevuto.

Se si contrassegna questo evento come gestito nella gestione delle classi, i subevent vengono ancora generati; tuttavia, passano lo stato gestito nei dati dell'evento. Se l'evento viene gestito nella gestione delle classi, i gestori di istanze per i subevent non vengono richiamati a meno che non si usi AddHandler(RoutedEvent, Delegate, Boolean) in modo esplicito per handledEventsTootrue collegare i gestori. I gestori di classi non vengono richiamati anche a meno che tali gestori di classi non siano stati registrati con la RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) firma con handledEventsTootrue. OnPreviewMouseDownGestendo , si implica che la gestione della classe ha eseguito l'account per tutte le possibili azioni del pulsante del mouse verso il basso. Questo comportamento potrebbe essere indesiderato. Pertanto, prestare attenzione quando si usa questo metodo virtuale per contrassegnare gli eventi come gestiti.

Ognuno degli eventi diretti specifici del pulsante ha anche un metodo On* virtuale; valutare se eseguire l'override di questi gestori di classi specifici del pulsante potrebbe essere più appropriato.

Questo metodo non ha alcuna implementazione predefinita. Poiché una classe intermedia nell'ereditarietà potrebbe implementare questo metodo, è consigliabile chiamare l'implementazione di base nell'implementazione.

Lo scopo di questo metodo è simile ai metodi CLR (Common Language Runtime): questo metodo fornisce i mezzi per gestire l'evento corrispondente da classi derivate creando un gestore di classi anziché un gestore di istanze. In questo caso l'evento corrispondente è un evento instradato. Il modello di implementazione dei metodi On* è diverso per gli eventi indirizzati perché un evento indirizzato può essere generato da un elemento figlio, che non è necessariamente l'elemento che richiama gestori. Pertanto, l'implementazione deve esaminare le proprietà di origine dei dati dell'evento. Non dovrebbe provare a riraizzare l'evento nella maggior parte dei casi.

Eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandlerclassi derivate di UIElement3D può chiamare i metodi del gestore della classe privata quando l'evento viene ricevuto lungo la route dell'evento. Uno scenario in cui la gestione delle classi è appropriata consiste nel modificare i dati dell'evento e contrassegnare l'evento indirizzato come gestito. Un altro scenario specifico per gli eventi di anteprima consiste nel contrassegnarli gestiti in modo che i gestori di classi bubbling corrispondenti non vengano richiamati.

OnPreviewMouseDown viene introdotto in .NET Framework versione 3.5. Per altre informazioni, vedere Versioni e dipendenze.

Vedi anche

• PreviewMouseDown