FocusManager.TryMoveFocus Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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);
static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
public static bool TryMoveFocus(FocusNavigationDirection 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
bool
true si le focus a été déplacé ; sinon, false.
- Attributs
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é
S’applique à
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
bool
true si le focus a été déplacé ; sinon, false.
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10 Creators Update (introduit dans 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v4.0)
|
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é