ListBox.SingleSelectionFollowsFocus Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che indica se la selezione degli elementi cambia quando lo stato attivo della tastiera cambia.

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

Valore della proprietà

Boolean

bool

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

Questa proprietà viene ignorata se la proprietà SelectionMode della casella di riepilogo non è impostata su Single.

Per impostazione predefinita, quando una casella di riepilogo è configurata per la singola selezione, quando l'utente sposta lo stato attivo della tastiera su un elemento, viene selezionato anche l'elemento incentrato. 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, è consigliabile 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 è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della 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. In questo esempio viene illustrato come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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