Bagikan melalui

SearchBox.FocusOnKeyboardInput Properti

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml.Controls
Edit

Mendapatkan atau menetapkan nilai yang menentukan apakah pengguna dapat mencari dengan mengetik di mana saja di aplikasi.

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

void FocusOnKeyboardInput(bool value);
public bool FocusOnKeyboardInput { get; set; }
var boolean = searchBox.focusOnKeyboardInput;
searchBox.focusOnKeyboardInput = boolean;
Public Property FocusOnKeyboardInput As Boolean
<SearchBox FocusOnKeyboardInput="bool"/>

Nilai Properti

Boolean

bool

true jika pengguna dapat mencari dengan mengetik di mana saja di aplikasi; jika tidak, salah. Defaultnya adalah false.

Keterangan

Catatan

Saat FocusOnKeyboardInput diatur ke true, ada masalah yang terkadang membuat karakter duplikat di kontrol SearchBox saat menggunakan keyboard sentuh. Anda dapat mengatasi masalah ini dengan mengikuti langkah-langkah berikut:

  1. Nonaktifkan FocusOnKeyboardInput setelah SearchBox menerima fokus. Untuk melakukan ini, daftar untuk peristiwa PrepareForFocusOnKeyboardInput dan gunakan penanganan aktivitas untuk mengatur FocusOnKeyboardInput ke false.
  2. Saat Kotak Pencarian kehilangan fokus, atur FocusOnKeyboardInput kembali ke true. Untuk melakukan ini, daftar untuk peristiwa LostFocus dan gunakan penanganan aktivitas untuk mengatur FocusOnKeyboardInput kembali ke true.

Ketika FocusOnKeyboardInput benar, input keyboard pada utas saat ini dicegat dan input tekstual dialihkan ke SearchBox. Hanya input tekstual yang akan menyebabkan SearchBox menerima fokus. Tombol non-teks, seperti panah atau Tab, tidak dialihkan ke Kotak Pencarian. Kombinasi tombol WIN/CTRL/ALT (kecuali untuk Ctrl-V untuk tempel) juga tidak dialihkan.

Untuk melakukan lebih dari sekadar mengatur fokus di SearchBox, seperti membuat kontrol terlihat, tangani peristiwa PrepareForFocusOnKeyboardInput .

Anda harus mengatur FocusOnKeyboardInput ke false jika pengguna mengatur fokus pada beberapa bidang teks lain yang dapat diedit.

Untuk mempelajari selengkapnya tentang kapan Anda harus mengizinkan pengguna mengetik untuk mencari, lihat Panduan dan daftar periksa untuk pencarian.

Berlaku untuk

Lihat juga