FrameworkElement.OnGotFocus(RoutedEventArgs) Método

Definição

Invocado sempre que um evento GotFocus sem tratamento acessa esse elemento em sua rota.Invoked whenever an unhandled GotFocus event reaches this element in its route.

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.The RoutedEventArgs that contains the event data.

Comentários

Ao contrário de outros métodos em * expostos pelos elementos base, OnGotFocus tem uma implementação padrão.Unlike some other On* methods exposed by the base elements, OnGotFocus does have a default implementation. Especificamente, ele tem uma implementação que substitui a implementação nula no próximo nível do elemento base, OnGotFocus.Specifically, it has an implementation that overrides the null implementation in the next level of base element down, OnGotFocus. Quando invocado, OnGotFocus define o comportamento de foco apropriado nesse elemento nos casos em que o evento foi originado do elemento atual devido ao foco do teclado.When invoked, OnGotFocus sets appropriate focus behavior on this element in cases where the event originated from the current element due to keyboard focus. O manipulador de OnGotFocus não marca os argumentos de evento como manipulados, mesmo quando o foco é definido como o elemento atual.The OnGotFocus handler does not mark the event arguments as handled, even when focus is set to the current element. Se a origem do evento fosse outro elemento na árvore (não o elemento atual), o manipulador não fará nada.If the event's source was another element in the tree (not the current element), the handler does nothing.

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 feito não permitindo que o elemento esteja em foco (consulte Focusable).You can override this method in order to change the default focus behavior on your element, but be aware that changing focus behavior in this way might be better accomplished by not allowing the element to be focusable at all (see Focusable).

Notas aos Herdeiros

Se você pretende marcar o evento manipulado nos argumentos, deve estar ciente de conseqüências na manipulação de eventos em outros elementos pai na árvore de elementos.If you intend to mark the event handled in the arguments, you should be aware of consequences on event handling in other parent elements in the element tree. Como esse manipulador atua em um evento com um roteamento de bolha, definir o foco para o sender atual de acordo com os argumentos do evento pode não ser apropriado.Because this handler acts on an event with a bubbling routing, setting the focus to the current sender per the event arguments may not be appropriate. O foco pode precisar ir para um elemento filho composto ou para um elemento pai, dependendo da composição de determinados controles.Focus might need to go to either a composite child element or to a parent element, depending on the compositing of certain controls. Portanto, marcar um evento de foco como manipulado só é recomendado se a totalidade da árvore visual pela qual o evento está roteando fizer parte da composição de um controle que você criou.Therefore marking a focus event as handled is only recommended if the entirety of the visual tree that the event is routing through is part of compositing of a control that you authored.

Aplica-se a

Veja também