UIElement.OnKeyDown(KeyEventArgs) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Invocado quando um evento anexado KeyDown sem tratamento atinge um elemento em sua rota que deriva dessa classe. Implemente esse método para adicionar tratamento de classe a esse 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)

Parâmetros

e

KeyEventArgs

O KeyEventArgs que contém os dados do evento.

Comentários

Os pressionamentos de tecla são tratados por um gerenciador de entrada dedicado. Outros recursos de programação que dependem de pressionamentos de tecla, por exemplo, associações de entrada e comando, podem lidar com o pressionamento de tecla antes de ser exposto como um pressionamento de tecla geral. Se esses recursos do sistema de entrada marcarem o evento como manipulado, não OnKeyDown será invocado.

Esse método não tem nenhuma implementação padrão. Como uma classe intermediária na herança pode implementar esse método, recomendamos que você chame a implementação base em sua implementação.

A finalidade desse método é semelhante aos métodos de clr (common language runtime): esse método fornece os meios para lidar com o evento correspondente de classes derivadas estabelecendo um manipulador de classe em vez de um manipulador de instância. Nesse caso, o evento correspondente é um evento roteado. O padrão de implementação dos métodos On* é diferente para eventos roteados porque um evento roteado pode ser gerado por um elemento filho, que não é necessariamente o elemento que invocará manipuladores. Portanto, sua implementação precisa examinar as propriedades de origem dos dados do evento. Ele não deve tentar recriar o evento na maioria dos casos.

Substituindo esse método ou registrando manipuladores de classe com RegisterClassHandler, classes derivadas de podem chamar métodos de UIElement manipulador de classe privada quando o evento é recebido ao longo da rota do evento. Um cenário em que o tratamento de classe é apropriado é manipular os dados do evento e marcar o evento roteado como manipulado.

Confira também

• KeyDown