ListBox.SingleSelectionFollowsFocus Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui indique si la sélection d’élément change lorsque le focus du clavier change.

public:
 property bool SingleSelectionFollowsFocus { bool get(); void set(bool value); };

bool SingleSelectionFollowsFocus();

void SingleSelectionFollowsFocus(bool value);

public bool SingleSelectionFollowsFocus { get; set; }

var boolean = listBox.singleSelectionFollowsFocus;
listBox.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<ListBox SingleSelectionFollowsFocus="bool" />

Valeur de propriété

Boolean

bool

true si la sélection d’élément change lorsque le focus du clavier change ; sinon, false. La valeur par défaut est true.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Cette propriété est ignorée si la propriété SelectionMode de la zone de liste n’est pas définie sur Single.

Par défaut, lorsqu’une zone de liste est configurée pour une sélection unique, lorsque l’utilisateur déplace le focus clavier vers un élément, l’élément prioritaire est également sélectionné. Par exemple, si le focus clavier est déplacé du premier élément vers le deuxième élément, la propriété SelectedIndex est mise à jour de 0 à 1.

Définissez cette propriété sur false pour permettre à un utilisateur de déplacer le focus sans la sélection d’élément suivante. Par exemple, si chaque modification de sélection entraîne des mises à jour importantes de l’interface utilisateur, vous pouvez préférer laisser l’utilisateur déplacer le focus sur un élément non adjacent, puis appuyer sur Entrée pour mettre à jour la sélection.

Compatibilité des versions

La propriété SingleSelectionFollowsFocus n’est pas disponible avant Windows 10, version 1607. Si le paramètre « version minimale de la plateforme » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions précédentes de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

<ListBox x:Name="listBox1" Loaded="ListBox_Loaded"/>

private void ListBox_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ListBox", "SingleSelectionFollowsFocus"))
    {
        listBox1.SingleSelectionFollowsFocus = false;
    }
}