UIElement.OnPreviewStylusOutOfRange(StylusEventArgs) 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.
Viene richiamato ogni qualvolta un evento PreviewStylusOutOfRange connesso 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:
virtual void OnPreviewStylusOutOfRange(System::Windows::Input::StylusEventArgs ^ e);
protected virtual void OnPreviewStylusOutOfRange (System.Windows.Input.StylusEventArgs e);
abstract member OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
override this.OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
Protected Overridable Sub OnPreviewStylusOutOfRange (e As StylusEventArgs)
Parametri
Oggetto StylusEventArgs che contiene i dati dell'evento.
Commenti
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 UIElement 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.