ContentElement.OnPreviewKeyDown(KeyEventArgs) ContentElement.OnPreviewKeyDown(KeyEventArgs) ContentElement.OnPreviewKeyDown(KeyEventArgs) ContentElement.OnPreviewKeyDown(KeyEventArgs) Method

Definizione

Viene richiamato ogni qualvolta un evento PreviewKeyDown connesso non gestito raggiunge un elemento nella propria route derivato da questa classe.Invoked when an unhandled PreviewKeyDown attached event reaches an element in its route that is derived from this class. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.Implement this method to add class handling for this event.

protected public:
 virtual void OnPreviewKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected internal virtual void OnPreviewKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Friend Overridable Sub OnPreviewKeyDown (e As KeyEventArgs)

Parametri

e
KeyEventArgs KeyEventArgs KeyEventArgs KeyEventArgs

Oggetto KeyEventArgs che contiene i dati dell'evento.The KeyEventArgs that contains the event data.

Commenti

Questo metodo presenta alcuna implementazione predefinita.This method has no default implementation. Poiché una classe intermedia nell'ereditarietà potrà implementare questo metodo, si consiglia di chiamare l'implementazione di base nell'implementazione.Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

Lo scopo di questo metodo è simile al Common Language Runtime (CLR)common language runtime (CLR) schema di eventi su* metodi: questo metodo fornisce i mezzi per gestire l'evento corrispondente dalle classi derivate, stabilendo un gestore della classe anziché un gestore di istanze.The purpose of this method is similar to the Common Language Runtime (CLR)common language runtime (CLR) event pattern On* methods: this method provides the means to handle the matching event from derived classes by establishing a class handler instead of an instance handler. In questo caso l'evento corrispondente è un evento indirizzato.In this case the matching event is a routed event. Il modello di implementazione di On* metodi è diversa per gli eventi indirizzati poiché un evento indirizzato può essere generato da un elemento figlio, che non corrisponde necessariamente all'elemento che richiama i gestori.The implementation pattern of the On* methods is different for routed events because a routed event can be raised by a child element, which is not necessarily the element that will invoke handlers. Pertanto, l'implementazione deve esaminare le proprietà dell'origine dei dati dell'evento.Therefore, your implementation needs to examine the source properties of the event data. Consigliabile non rigenerare l'evento nella maggior parte dei casi.It should not try to reraise the event in most cases.

Eseguendo l'override di questo metodo o tramite la registrazione di gestori di classi con RegisterClassHandler, le classi derivate di ContentElement può chiamare metodi del gestore di classe privata quando viene ricevuto l'evento lungo la route dell'evento.Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of ContentElement can call private class handler methods when the event is received along the event route. Uno scenario in cui la gestione di classi è appropriata consiste nel modificare i dati dell'evento e contrassegnare l'evento indirizzato come gestito.One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled. Un altro scenario che è specifico per gli eventi di anteprima è per contrassegnarli gestiti in modo che non vengono richiamati i gestori di classi di bubbling corrispondente.Another scenario that is specifically for Preview events is to mark them handled so that the matching bubbling class handlers are not invoked.

Si applica a

Vedi anche