Linguagem

FrameworkElement.OnGotFocus(RoutedEventArgs) Método

Definição

Invocado sempre que um evento não tratado GotFocus atinge este elemento na 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.

Observações

Ao contrário de alguns outros métodos On* expostos pelos elementos base, OnGotFocus tem uma implementação por defeito. Especificamente, tem uma implementação que sobrepõe a implementação nula no nível seguinte do elemento base para baixo, OnGotFocus. Quando invocado, OnGotFocus define o comportamento de foco apropriado neste elemento nos casos em que o evento teve origem no elemento atual devido ao foco do teclado. O OnGotFocus handler não marca os argumentos do evento como tratados, mesmo quando o foco está definido para o elemento atual. Se a fonte do evento fosse outro elemento na árvore (não o elemento atual), o handler não faz nada.

Podes ultrapassar este método para alterar o comportamento de foco padrão do teu elemento, mas tem em mente que mudar o comportamento de foco desta forma pode ser melhor conseguido não permitindo que o elemento seja focalizado de todo (ver Focusable).

Notas para Herdeiros

Se pretende marcar o evento tratado nos argumentos, deve estar ciente das consequências na gestão de eventos noutros elementos pais da árvore de elementos. Como este handler atua num evento com um encaminhamento borbulhante, definir o foco para o argumento atual sender de acordo com os argumentos do evento pode não ser apropriado. O foco pode precisar de ir para um elemento filho composto ou para um elemento pai, dependendo da composição de certos controlos. Portanto, marcar um evento de foco como tratado só é recomendado se toda a árvore visual por onde o evento está a ser encaminhado fizer parte da composição de um controlo que criou.

Aplica-se a

Ver também