Partilhar via


FrameworkElement.OnGotFocus(RoutedEventArgs) Método

Definição

Invocado sempre que um evento GotFocus sem tratamento acessa esse elemento em sua rota.

protected:
 override void OnGotFocus(System::Windows::RoutedEventArgs ^ e);
protected override void OnGotFocus (System.Windows.RoutedEventArgs e);
override this.OnGotFocus : System.Windows.RoutedEventArgs -> unit
Protected Overrides Sub OnGotFocus (e As RoutedEventArgs)

Parâmetros

e
RoutedEventArgs

O RoutedEventArgs que contém os dados do evento.

Comentários

Ao contrário de alguns outros métodos On* expostos pelos elementos base, OnGotFocus o tem uma implementação padrão. Especificamente, ele tem uma implementação que substitui a implementação nula no próximo nível do elemento base para baixo, OnGotFocus. Quando invocado, OnGotFocus define o comportamento de foco apropriado nesse elemento nos casos em que o evento se originou do elemento atual devido ao foco do teclado. O OnGotFocus manipulador não marca os argumentos de evento como manipulados, mesmo quando o foco é definido como o elemento atual. Se a origem do evento for outro elemento na árvore (não o elemento atual), o manipulador não fará nada.

Você pode substituir esse método para alterar o comportamento de foco padrão em seu elemento, mas lembre-se de que alterar o comportamento de foco dessa maneira pode ser melhor realizado, não permitindo que o elemento seja focalizável (consulte Focusable).

Notas aos Herdeiros

Se você pretende marcar o evento tratado nos argumentos, deve estar ciente das consequências no tratamento de eventos em outros elementos pai na árvore de elementos. Como esse manipulador atua em um evento com um roteamento borbulhante, definir o foco como o atual sender de acordo com os argumentos de evento pode não ser apropriado. O foco pode precisar ir para um elemento filho composto ou para um elemento pai, dependendo da composição de determinados controles. Portanto, marcar um evento de foco como manipulado só será recomendado se a totalidade da árvore visual pela qual o evento está roteando faz parte da composição de um controle que você criou.

Aplica-se a

Confira também