ListBox.SingleSelectionFollowsFocus Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur qui indique si la sélection d’élément change lorsque le focus 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 clavier change ; sinon, false. La valeur par défaut est true.

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 sur 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 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 de plateforme minimale » 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 tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures 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;
    }
}