ListViewBase.SingleSelectionFollowsFocus Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta un valore che indica se la selezione dell'elemento cambia quando cambia lo stato attivo della tastiera.

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" />

Valore della proprietà

Boolean

bool

true se la selezione dell'elemento cambia quando cambia lo stato attivo della tastiera; in caso contrario, false. Il valore predefinito è True.

Commenti

Questa proprietà viene ignorata se la proprietà SelectionMode della visualizzazione elenco non è impostata su Single.

Per impostazione predefinita, quando una visualizzazione elenco è configurata per la selezione singola, quando l'utente sposta lo stato attivo della tastiera su un elemento, viene selezionato anche l'elemento attivo. Ad esempio, se lo stato attivo della tastiera viene spostato dal primo elemento al secondo elemento, la proprietà SelectedIndex viene aggiornata da 0 a 1.

Impostare questa proprietà su false per consentire a un utente di spostare lo stato attivo senza la selezione dell'elemento seguente. Ad esempio, se ogni modifica di selezione causa aggiornamenti significativi dell'interfaccia utente, potrebbe essere preferibile consentire all'utente di spostare lo stato attivo su un elemento non adiacente e quindi premere INVIO per aggiornare la selezione.

Compatibilità tra versioni

La proprietà SingleSelectionFollowsFocus non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

<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;
    }
}