ComboBox.IsTextSearchEnabled Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau menetapkan nilai yang menentukan apakah pengguna dapat melompat ke nilai dengan mengetik.

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

bool IsTextSearchEnabled();

void IsTextSearchEnabled(bool value);

public bool IsTextSearchEnabled { get; set; }

var boolean = comboBox.isTextSearchEnabled;
comboBox.isTextSearchEnabled = boolean;

Public Property IsTextSearchEnabled As Boolean

<ComboBox IsTextSearchEnabled="bool"/>

Nilai Properti

Boolean

bool

true jika pengguna dapat melompat ke nilai dengan mengetik; 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

Mulai dari Windows 10, versi 1607, ComboBox memperkenalkan fitur pencarian teks. Secara default, ComboBox melompat ke nilai yang relevan sebagai jenis pengguna. Anda dapat mengatur properti IsTextSearchEnabled ke false untuk menonaktifkan perilaku ini. Ini berguna, misalnya, jika Anda telah memperluas ComboBox dengan pencarian teks kustom.

Kompatibilitas versi

Properti IsTextSearchEnabled 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.

Catatan

Fitur pencarian teks tersedia saat aplikasi Anda dikompilasi untuk Windows 10, versi 1607 dan berjalan pada versi 1607 (atau yang lebih baru). Ini tidak tersedia saat aplikasi Anda dikompilasi untuk versi sebelumnya atau berjalan pada versi sebelumnya.

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.

<ComboBox x:Name="comboBox1" Loaded="ComboBox_Loaded"/>

private void ComboBox_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ComboBox", "IsTextSearchEnabled"))
    {
        comboBox1.IsTextSearchEnabled = false;
    }
}