UIElement3D.OnPreviewMouseDown(MouseButtonEventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Richiamato quando un evento indirizzato non gestito PreviewMouseDown collegato raggiunge un elemento nella route derivata 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 -> unitProtected Friend Overridable Sub OnPreviewMouseDown (e As MouseButtonEventArgs)Parametri
MouseButtonEventArgs che contiene i dati dell'evento. I dati dell'evento segnalano 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 le associazioni di input e di comando, potrebbero richiamare i gestori per l'azione prima che venga esposta come azione generale del pulsante del mouse. Se queste funzionalità del 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 ricevente quando viene ricevuto Mouse.PreviewMouseDown.
Se si contrassegna questo evento come gestito nella gestione delle classi, gli eventi secondari vengono comunque generati; Tuttavia, passano lo stato gestito nei dati dell'evento. Se l'evento viene gestito nella gestione delle classi, i gestori di istanza per gli eventi secondari non vengono richiamati a meno che non si usi in modo esplicito AddHandler(RoutedEvent, Delegate, Boolean) con handledEventsTootrue per collegare i gestori. I gestori di classe non vengono richiamati anche a meno che tali gestori di classe non siano stati registrati con la firma di RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) con handledEventsTootrue. Gestendo OnPreviewMouseDown, si implica che la classe che gestisce 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.
Ogni evento diretto specifico del pulsante ha anche un metodo On* virtuale; valutare se l'override di questi gestori di classi specifici del pulsante potrebbe essere più appropriato.
Questo metodo non ha un'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 On* di Common Language Runtime (CLR): questo metodo fornisce i mezzi per gestire l'evento corrispondente dalle classi derivate stabilendo un gestore classi anziché un gestore di istanze. In questo caso l'evento corrispondente è un evento indirizzato. 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 richiamerà i gestori. Pertanto, l'implementazione deve esaminare le proprietà di origine dei dati dell'evento. Non dovrebbe cercare di ristabilire l'evento nella maggior parte dei casi.
Eseguendo l'override di questo metodo o registrando i gestori di classe con RegisterClassHandler, le classi derivate di UIElement3D possono chiamare metodi del gestore di classi private 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.
