ContentElement.OnKeyDown(KeyEventArgs) Método

Definição

Invocado quando um evento anexo não tratado KeyDown atinge um elemento na sua rota derivado desta classe. Implemente este método para adicionar o tratamento de classes para este evento.

protected public:
 virtual void OnKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected internal 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 Friend Overridable Sub OnKeyDown (e As KeyEventArgs)

Parâmetros

e
KeyEventArgs

O KeyEventArgs que contém os dados do evento.

Observações

As teclas são tratadas por um gestor de entradas dedicado. Outras funcionalidades de programação que dependem de pressionamentos de teclas, por exemplo, atribuições de entrada e comandos, podem tratar da tecla antes de ser exposta como uma tecla geral. Se estas funcionalidades do sistema de entrada marcarem o evento como tratado, então OnKeyDown não é invocado.

Este método não tem implementação por defeito. Como uma classe intermédia na herança pode implementar este método, recomendamos que chame a implementação base na sua implementação.

O objetivo deste método é semelhante ao padrão de eventos On* em tempo de execução da linguagem comum (CLR): este método fornece os meios para lidar com o evento correspondente de classes derivadas, estabelecendo um gestor de classes em vez de um gestor de instâncias. Neste caso, o evento de correspondência é um evento encaminhado. O padrão de implementação dos métodos On* é diferente para eventos encaminhados porque um evento encaminhado pode ser gerado por um elemento filho, que não é necessariamente o elemento que irá invocar os handlers. Por isso, a sua implementação precisa de examinar as propriedades de origem dos dados do evento. Na maioria dos casos, não deve tentar reabrir o evento.

Quer sobrescrevendo este método, quer registando manipuladores de classe com RegisterClassHandler, classes derivadas de ContentElement podem chamar métodos de gestores privados de classes quando o evento é recebido ao longo da rota do evento. Um cenário em que o tratamento de classes é apropriado é manipular os dados do evento e marcar o evento encaminhado como tratado.

Aplica-se a

Ver também