ListViewBase.SingleSelectionFollowsFocus Propriété

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

bool SingleSelectionFollowsFocus();

void SingleSelectionFollowsFocus(bool value);

public bool SingleSelectionFollowsFocus { get; set; }

var boolean = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<listViewBase SingleSelectionFollowsFocus="bool" />

Valeur de propriété

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 l’affichage de liste n’est pas définie sur Single.

Par défaut, lorsqu’un affichage de liste est configuré 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 au 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 provoque des mises à jour importantes de l’interface utilisateur, vous pouvez préférer laisser l’utilisateur déplacer le focus vers 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 Conditions requises plus loin dans cette page, vous devez concevoir et tester votre application pour 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 utilisez-la sans effectuer de vérification du runtime. Cet exemple montre comment utiliser la classe ApiInformation pour vérifier la présence de cette propriété avant de la définir.

<ListView x:Name="listView1" Loaded="ListView_Loaded"/>

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