Partilhar via


ContentElement.OnPreviewGotKeyboardFocus Método

Definição

Invocado quando um evento anexado PreviewGotKeyboardFocus 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 public:
 virtual void OnPreviewGotKeyboardFocus(System::Windows::Input::KeyboardFocusChangedEventArgs ^ e);
protected internal virtual void OnPreviewGotKeyboardFocus (System.Windows.Input.KeyboardFocusChangedEventArgs e);
abstract member OnPreviewGotKeyboardFocus : System.Windows.Input.KeyboardFocusChangedEventArgs -> unit
override this.OnPreviewGotKeyboardFocus : System.Windows.Input.KeyboardFocusChangedEventArgs -> unit
Protected Friend Overridable Sub OnPreviewGotKeyboardFocus (e As KeyboardFocusChangedEventArgs)

Parâmetros

e
KeyboardFocusChangedEventArgs

O KeyboardFocusChangedEventArgs que contém os dados do evento.

Comentários

Esse método não tem 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 On* do padrão de evento CLR (Common Language Runtime): esse método fornece os meios para manipular 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 novamente 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 ContentElement manipulador de classe privada quando o evento é recebido ao longo da rota de evento. Um cenário em que o tratamento de classe é apropriado é manipular os dados do evento e marcar o evento roteado como manipulado. Outro cenário especificamente para eventos de versão prévia é marcá-los manipulados para que os manipuladores de classe de propagação correspondentes não sejam invocados.

Aplica-se a

Confira também