Gunakan cakupan masukan untuk mengubah keyboard sentuh

Untuk membantu pengguna memasukkan data menggunakan keyboard sentuh, atau Panel Input Lunak (SIP), Anda dapat mengatur cakupan input kontrol teks agar sesuai dengan jenis data yang diharapkan dimasukkan pengguna.

API penting

• LingkupMasukan
• NamaNilaiLingkupMasukan

Keyboard sentuh dapat digunakan untuk entri teks saat aplikasi Anda berjalan di perangkat dengan layar sentuh. Keyboard sentuh dipanggil saat pengguna mengetuk bidang input yang dapat diedit, seperti TextBox atau RichEditBox. Anda dapat membuatnya jauh lebih cepat dan lebih mudah bagi pengguna untuk memasukkan data di aplikasi Anda dengan mengatur cakupan input kontrol teks agar sesuai dengan jenis data yang Anda harapkan untuk dimasukkan pengguna. Cakupan input memberikan petunjuk kepada sistem tentang jenis input teks yang diharapkan oleh kontrol sehingga sistem dapat menyediakan tata letak keyboard sentuh khusus untuk jenis input.

Misalnya, jika kotak teks hanya digunakan untuk memasukkan PIN 4 digit, atur properti InputScope ke Angka. Ini memberi tahu sistem untuk menampilkan tata letak keypad angka, yang memudahkan pengguna untuk memasukkan PIN.

Penting

• Info ini hanya berlaku untuk SIP. Ini tidak berlaku untuk keyboard perangkat keras atau Keyboard Layar yang tersedia di opsi Kemudahan Akses Windows.
• Cakupan input tidak menyebabkan validasi input dilakukan, dan tidak mencegah pengguna memberikan input apa pun melalui keyboard perangkat keras atau perangkat input lainnya. Anda masih bertanggung jawab untuk memvalidasi input dalam kode Anda sesuai kebutuhan.

Mengubah cakupan input kontrol teks

Cakupan input yang tersedia untuk aplikasi Anda adalah anggota enumerasi InputScopeNameValue . Anda dapat mengatur properti InputScope dari TextBox atau RichEditBox ke salah satu nilai ini.

Penting

Properti InputScope pada PasswordBox hanya mendukung nilai Password dan NumericPin. Nilai lain diabaikan.

Di sini, Anda mengubah cakupan input beberapa kotak teks agar sesuai dengan data yang diharapkan untuk setiap kotak teks.

Untuk mengubah cakupan input XAML

1. Di file XAML untuk halaman Anda, temukan tag untuk kontrol teks yang ingin Anda ubah.

2. Tambahkan atribut InputScope ke tag dan tentukan nilai InputScopeNameValue yang cocok dengan input yang diharapkan.

   Berikut adalah beberapa kotak teks yang mungkin muncul di formulir kontak pelanggan umum. Dengan InputScope diatur, keyboard sentuh dengan tata letak yang sesuai untuk data yang ditampilkan untuk setiap kotak teks.

   <StackPanel Width="300">
       <TextBox Header="Name" InputScope="Default"/>
       <TextBox Header="Email Address" InputScope="EmailSmtpAddress"/>
       <TextBox Header="Telephone Number" InputScope="TelephoneNumber"/>
       <TextBox Header="Web site" InputScope="Url"/>
   </StackPanel>
   

Untuk mengubah cakupan input dalam kode

1. Di file XAML untuk halaman Anda, temukan tag untuk kontrol teks yang ingin Anda ubah. Jika tidak diatur, atur atribut x:Name sehingga Anda dapat mereferensikan kontrol dalam kode Anda.

   <TextBox Header="Telephone Number" x:Name="phoneNumberTextBox"/>
   

2. Instansiasi objek baru InputScope.

   InputScope scope = new InputScope();
   

3. Buat instance baru dari objek InputScopeName.

   InputScopeName scopeName = new InputScopeName();
   

4. Atur properti NameValue dari objek InputScopeName ke nilai dari enumerasi InputScopeNameValue.

   scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
   

5. Tambahkan objek InputScopeName ke kumpulan Names dari objek InputScope.

   scope.Names.Add(scopeName);
   

6. Atur objek InputScope sebagai nilai properti InputScope kontrol teks.

   phoneNumberTextBox.InputScope = scope;
   

Berikut adalah kode secara keseluruhan.

InputScope scope = new InputScope();
InputScopeName scopeName = new InputScopeName();
scopeName.NameValue = InputScopeNameValue.TelephoneNumber;
scope.Names.Add(scopeName);
phoneNumberTextBox.InputScope = scope;

Langkah yang sama dapat dikondensasikan ke dalam kode singkat ini.

phoneNumberTextBox.InputScope = new InputScope() 
{
    Names = {new InputScopeName(InputScopeNameValue.TelephoneNumber)}
};

Prediksi teks, pemeriksaan ejaan, dan koreksi otomatis

Kontrol TextBox dan RichEditBox memiliki beberapa properti yang memengaruhi perilaku SIP. Untuk memberikan pengalaman terbaik bagi pengguna Anda, penting untuk memahami bagaimana properti ini memengaruhi input teks menggunakan sentuhan.

• IsSpellCheckEnabled—Saat pemeriksaan ejaan diaktifkan untuk kontrol teks, kontrol berinteraksi dengan mesin pemeriksaan ejaan sistem untuk menandai kata-kata yang tidak dikenali. Anda dapat mengetuk kata untuk melihat daftar koreksi yang disarankan. Pemeriksaan ejaan diaktifkan secara default.

  Untuk lingkup input Default, properti ini juga memungkinkan kapitalisasi otomatis kata pertama dalam kalimat dan koreksi otomatis kata saat Anda mengetik. Fitur koreksi otomatis ini mungkin dinonaktifkan dalam cakupan input lainnya. Untuk informasi selengkapnya, lihat tabel nanti dalam topik ini.

• IsTextPredictionEnabled—Saat prediksi teks diaktifkan untuk kontrol teks, sistem menampilkan daftar kata yang mungkin mulai Anda ketik. Anda dapat memilih dari daftar sehingga Anda tidak perlu mengetik seluruh kata. Prediksi teks diaktifkan secara default.

  Prediksi teks mungkin tidak aktif jika cakupan input yang bukan Default, bahkan jika properti IsTextPredictionEnabled bernilai benar. Untuk informasi selengkapnya, lihat tabel nanti dalam topik ini.

• PreventKeyboardDisplayOnProgrammaticFocus—Ketika properti ini true, properti ini mencegah sistem menampilkan SIP ketika fokus diatur secara terprogram pada kontrol teks. Sebaliknya, keyboard hanya ditampilkan ketika pengguna berinteraksi dengan kontrol.

Indeks papan ketik sentuh untuk Windows

Tabel ini memperlihatkan tata letak Windows Soft Input Panel (SIP) untuk nilai cakupan input umum. Pengaruh cakupan input pada fitur yang diaktifkan oleh properti IsSpellCheckEnabled dan IsTextPredictionEnabled tercantum untuk setiap cakupan input. Ini bukan daftar komprehensif cakupan input yang tersedia.

Petunjuk / Saran

Anda dapat mengalihkan sebagian besar keyboard sentuh antara tata letak alfabet dan tata letak angka dan simbol dengan menekan tombol &123 untuk mengubah ke tata letak angka dan simbol, dan menekan tombol abcd untuk mengubah ke tata letak alfabet.

Bawaan

<TextBox InputScope="Default"/>

Papan ketik sentuh bawaan Windows.

• Pemeriksaan ejaan: diaktifkan jika IsSpellCheckEnabled = true, dinonaktifkan jika IsSpellCheckEnabled = false
• Koreksi otomatis: diaktifkan jika IsSpellCheckEnabled = benar, dinonaktifkan jika IsSpellCheckEnabled = salah
• Kapitalisasi otomatis: diaktifkan jika IsSpellCheckEnabled = benar, dinonaktifkan jika IsSpellCheckEnabled = salah
• Prediksi teks: diaktifkan jika IsTextPredictionEnabled = true, dinonaktifkan jika IsTextPredictionEnabled = false

JumlahDanSimbolMataUang

<TextBox InputScope="CurrencyAmountAndSymbol"/>

Tata letak keyboard angka dan simbol default.

• Menyertakan kunci kiri/kanan halaman untuk menampilkan lebih banyak simbol
• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

URL

<TextBox InputScope="Url"/>

• Menyertakan .com dan kunci (Go). Tekan dan tahan tombol .com untuk menampilkan opsi tambahan (.org, .net, dan akhiran khusus wilayah)
• Termasuk tombol :, -, dan /
• Pemeriksaan ejaan: nonaktif secara default, dapat diaktifkan
• Koreksi otomatis: nonaktif secara default, dapat diaktifkan
• Kapitalisasi otomatis: nonaktif secara default, dapat diaktifkan
• Prediksi teks: nonaktif secara default, dapat diaktifkan

AlamatEmailSMTP

<TextBox InputScope="EmailSmtpAddress"/>

• Menyertakan kunci @ dan .com. Tekan dan tahan tombol .com untuk menampilkan opsi tambahan (.org, .net, dan akhiran khusus wilayah)
• Termasuk _ dan - kunci
• Pemeriksaan ejaan: nonaktif secara default, dapat diaktifkan
• Koreksi otomatis: nonaktif secara default, dapat diaktifkan
• Kapitalisasi otomatis: nonaktif secara default, dapat diaktifkan
• Prediksi teks: nonaktif secara default, dapat diaktifkan

Angka

<TextBox InputScope="Number"/>

• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

Nomor Telepon

<TextBox InputScope="TelephoneNumber"/>

• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

Cari

<TextBox InputScope="Search"/>

• Menyertakan kunci Pencarian alih-alih kunci Enter
• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

SearchIncremental

<TextBox InputScope="SearchIncremental"/>

• Tata letak yang sama dengan Default
• Pemeriksaan ejaan: nonaktif secara default, dapat diaktifkan
• Koreksi otomatis: selalu dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: selalu dinonaktifkan

Rumus

<TextBox InputScope="Formula"/>

• Menyertakan kunci =
• Juga termasuk kunci %, kunci $, dan kunci +.
• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: selalu dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

Percakapan

<TextBox InputScope="Chat"/>

• Tata letak yang sama dengan Default
• Pemeriksaan ejaan: aktif secara default, dapat dinonaktifkan
• Koreksi otomatis: aktif secara default, dapat dinonaktifkan
• Kapitalisasi otomatis: aktif secara default, dapat dinonaktifkan
• Prediksi teks: aktif secara default, dapat dinonaktifkan

NamaAtauNomorTelepon

<TextBox InputScope="NameOrPhoneNumber"/>

• Tata letak yang sama dengan Default
• Pemeriksaan ejaan: nonaktif secara default, dapat diaktifkan
• Koreksi otomatis: nonaktif secara default, dapat diaktifkan
• Kapitalisasi otomatis: nonaktif secara default, dapat diaktifkan (huruf pertama dari setiap kata dikapitalisasi)
• Prediksi teks: nonaktif secara default, dapat diaktifkan