FrameworkElement.OnGotFocus(RoutedEventArgs) Méthode

Définition

Appelée chaque fois qu'un événement routé GotFocus non géré rencontre cet élément sur son itinéraire.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)

Paramètres

e
RoutedEventArgs

RoutedEventArgs qui contient les données d'événement.The RoutedEventArgs that contains the event data.

Remarques

Contrairement à d’autres méthodes on * exposées par les éléments de base, OnGotFocus dispose d’une implémentation par défaut.Unlike some other On* methods exposed by the base elements, OnGotFocus does have a default implementation. En particulier, il a une implémentation qui remplace l’implémentation null dans le niveau suivant de l’élément de base, OnGotFocus .Specifically, it has an implementation that overrides the null implementation in the next level of base element down, OnGotFocus. En cas d’appel, OnGotFocus définit le comportement de focus approprié sur cet élément dans les cas où l’événement provient de l’élément actuel en raison du focus clavier.When invoked, OnGotFocus sets appropriate focus behavior on this element in cases where the event originated from the current element due to keyboard focus. Le OnGotFocus gestionnaire ne marque pas les arguments d’événement comme étant gérés, même lorsque le focus est défini sur l’élément actuel.The OnGotFocus handler does not mark the event arguments as handled, even when focus is set to the current element. Si la source de l’événement était un autre élément de l’arborescence (pas l’élément actuel), le gestionnaire n’a aucun effet.If the event's source was another element in the tree (not the current element), the handler does nothing.

Vous pouvez substituer cette méthode afin de modifier le comportement par défaut du focus sur votre élément, mais sachez que la modification du comportement de focus de cette façon peut être plus efficace en empêchant l’élément d’être actif du tout (consultez 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).

Notes pour les héritiers

Si vous envisagez de marquer l’événement comme étant géré dans les arguments, vous devez être conscient des conséquences sur la gestion des événements dans d’autres éléments parents de l’arborescence d’éléments.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. Étant donné que ce gestionnaire agit sur un événement avec un routage de propagation, le fait de définir le focus sur le en cours sender par les arguments d’événement peut ne pas être approprié.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. Le focus peut avoir besoin d’accéder à un élément enfant composite ou à un élément parent, en fonction de la composition de certains contrôles.Focus might need to go to either a composite child element or to a parent element, depending on the compositing of certain controls. Par conséquent, le marquage d’un événement de focus comme géré est recommandé uniquement si l’intégralité de l’arborescence d’éléments visuels dans laquelle l’événement est routé fait partie de la composition d’un contrôle que vous avez créé.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.

S’applique à

Voir aussi