UIElement.OnKeyDown(KeyEventArgs) Metodo

Definizione

Viene richiamato ogni qualvolta un evento KeyDown 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 OnKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected virtual void OnKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Overridable Sub OnKeyDown (e As KeyEventArgs)

Parametri

e
KeyEventArgs

Oggetto KeyEventArgs che contiene i dati dell'evento.

Commenti

Le sequenze di tasti vengono gestite da un gestore di input dedicato. Altre funzionalità di programmazione che si basano su sequenze di tasti, ad esempio le associazioni di input e di comando, possono gestire la sequenza di tasti prima che venga esposta come sequenza di tasti generale. Se queste funzionalità del sistema di input contrassegnano l'evento come gestito, OnKeyDown non viene richiamato.

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 On* di Common Language Runtime (Common Language Runtime): questo metodo fornisce i mezzi per gestire l'evento corrispondente dalle classi derivate stabilendo un gestore di 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 tentare di riramettere l'evento nella maggior parte dei casi.

Eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandler, le classi derivate di UIElement 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.

Si applica a

Vedi anche