FocusManager.TryMoveFocus Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Input

Surcharges

TryMoveFocus(FocusNavigationDirection)	Tente de changer le focus de l’élément avec focus sur l’élément pouvant être focusé suivant dans le sens spécifié.
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)	Tente de remplacer le focus de l’élément avec focus sur l’élément suivant dans le sens spécifié, à l’aide des options de navigation spécifiées.

TryMoveFocus(FocusNavigationDirection)

Tente de changer le focus de l’élément avec focus sur l’élément pouvant être focusé suivant dans le sens spécifié.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);

/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);

[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);

function tryMoveFocus(focusNavigationDirection)

Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

Paramètres

focusNavigationDirection

FocusNavigationDirection

Direction à parcourir (dans l’ordre de tabulation).

Retours

Boolean

bool

true si le focus a été déplacé ; sinon, false.

Attributs

OverloadAttribute

Remarques

L’ordre de tabulation est l’ordre dans lequel un utilisateur passe d’un contrôle à un autre en appuyant sur tab (avant) ou Maj+Tab (vers l’arrière).

Cette méthode utilise la séquence d’ordre de tabulation et le comportement pour parcourir tous les éléments pouvant être concentrés dans l’interface utilisateur.

• Si le focus se trouve sur le premier élément dans l’ordre de tabulation et que FocusNavigationDirection.Previous est spécifié, le focus se déplace vers le dernier élément.
• Si le focus se trouve sur le dernier élément dans l’ordre de tabulation et que FocusNavigationDirection.Next est spécifié, le focus se déplace vers le premier élément.

Vous pouvez également utiliser la méthode FindNextElement(FocusNavigationDirection, FindNextElementOptions) ou la méthode FindNextElement(FocusNavigationDirection) pour déplacer le focus par programmation. Ces méthodes récupèrent l’élément (en tant que DependencyObject) qui recevra le focus en fonction du sens de navigation spécifié (la navigation directionnelle uniquement ne peut pas être utilisée pour émuler la navigation par onglet).

Notes

Nous vous recommandons d’utiliser la méthode FindNextElement au lieu de FindNextFocusableElement , car FindNextFocusableElement récupère un UIElement, qui retourne null si l’élément focusable suivant n’est pas un UIElement (tel qu’un objet Hyperlink ).

Voir aussi

• TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
• Interactions avec le clavier
• Navigation au focus pour le clavier, le boîtier de commande, le contrôle à distance et les outils d’accessibilité
• Navigation en mode focus programmé

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Tente de remplacer le focus de l’élément avec focus sur l’élément suivant dans le sens spécifié, à l’aide des options de navigation spécifiées.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);

/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);

[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);

function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)

Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Boolean

Paramètres

focusNavigationDirection

FocusNavigationDirection

Direction à parcourir (dans l’ordre de tabulation).

focusNavigationOptions

FindNextElementOptions

Options permettant d’identifier l’élément suivant à recevoir le focus avec le clavier/le contrôleur/la navigation à distance.

Retours

Boolean

bool

true si le focus a été déplacé ; sinon, false.

Attributs

OverloadAttribute

Remarques

L’ordre de tabulation est l’ordre dans lequel un utilisateur passe d’un contrôle à un autre en appuyant sur tab (avant) ou Maj+Tab (vers l’arrière).

Cette méthode utilise la séquence d’ordre de tabulation et le comportement pour parcourir tous les éléments pouvant être concentrés dans l’interface utilisateur.

• Si le focus se trouve sur le premier élément dans l’ordre de tabulation et que FocusNavigationDirection.Previous est spécifié, le focus se déplace vers le dernier élément.
• Si le focus se trouve sur le dernier élément dans l’ordre de tabulation et que FocusNavigationDirection.Next est spécifié, le focus se déplace vers le premier élément.

Vous pouvez également utiliser la méthode FindNextElement(FocusNavigationDirection, FindNextElementOptions) ou la méthode FindNextElement(FocusNavigationDirection) pour déplacer le focus par programmation. Ces méthodes récupèrent l’élément (en tant que DependencyObject) qui recevra le focus en fonction du sens de navigation spécifié (la navigation directionnelle uniquement ne peut pas être utilisée pour émuler la navigation par onglet).

Notes

Nous vous recommandons d’utiliser la méthode FindNextElement au lieu de FindNextFocusableElement , car FindNextFocusableElement récupère un UIElement, qui retourne null si l’élément focusable suivant n’est pas un UIElement (tel qu’un objet Hyperlink ).

Voir aussi

• TryMoveFocus(FocusNavigationDirection)
• Interactions avec le clavier
• Navigation au focus pour le clavier, le boîtier de commande, le contrôle à distance et les outils d’accessibilité
• Navigation en mode focus programmé