ListBox.SingleSelectionFollowsFocus Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur nilai yang menunjukkan apakah pilihan item berubah saat fokus keyboard berubah.

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

Nilai Properti

Boolean

bool

true jika pilihan item berubah ketika fokus keyboard berubah; jika tidak, salah. Defaultnya adalah true

Persyaratan Windows

Rangkaian perangkat	Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Properti ini diabaikan jika properti SelectionMode kotak daftar tidak diatur ke Tunggal.

Secara default, saat kotak daftar dikonfigurasi untuk pilihan tunggal, saat pengguna memindahkan fokus keyboard ke item, item yang difokuskan juga dipilih. Misalnya, jika fokus keyboard dipindahkan dari item pertama ke item kedua, properti SelectedIndex diperbarui dari 0 ke 1.

Atur properti ini ke false untuk memungkinkan pengguna memindahkan fokus tanpa pilihan item berikut. Misalnya, jika setiap perubahan pilihan menyebabkan pembaruan UI yang signifikan, Anda mungkin lebih suka membiarkan pengguna memindahkan fokus ke item yang tidak berdekatan lalu tekan enter untuk memperbarui pilihan.

Kompatibilitas versi

Properti SingleSelectionFollowsFocus tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

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