Bagikan melalui

MaskedTextBox.SkipLiterals Properti

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna diizinkan untuk memasukkan kembali nilai harfiah.

public:
 property bool SkipLiterals { bool get(); void set(bool value); };
public bool SkipLiterals { get; set; }
member this.SkipLiterals : bool with get, set
Public Property SkipLiterals As Boolean

Nilai Properti

Boolean

true untuk memungkinkan harfiah untuk diinisiasi kembali; jika tidak, false untuk mencegah pengguna menimpa karakter harfiah. Default adalah true.

Keterangan

Masker input umumnya mengandung literal. Ketika pengguna memasukkan karakter ke MaskedTextBox dalam pada runtime, posisi karakter saat ini terkadang akan jatuh pada harfiah. Properti SkipLiterals menjelaskan bagaimana input pengguna untuk karakter berikutnya akan ditangani, sebagai berikut:

  • Jika properti ini adalah true, pengguna dapat secara berlebihan memasukkan karakter yang sama dengan harfiah pada posisi saat ini, atau dapat memasukkan karakter yang dapat diedit berikutnya, sehingga melompat posisi saat ini ke posisi tersebut.

  • Jika properti ini adalah false, pengguna hanya dapat memasukkan karakter yang dapat diedit berikutnya. Jika posisi berikutnya dalam masker tidak akan menerima karakter harfiah (misalnya, jenis pengguna "/" dan posisi berikutnya hanya menerima digit), kontrol akan menaikkan MaskInputRejected peristiwa.

Sebagai contoh, dalam masker entri tanggal "90/90/0000", karakter garis miring ke depan adalah harfiah. Asumsikan bahwa pengguna telah memasukkan dua digit awal, "11", sehingga posisi saat ini dalam masker adalah pada garis miring (/) literal pertama. Jika SkipLiterals adalah true, maka pengguna memiliki pilihan yang valid berikut:

  • Pengguna dapat memasukkan karakter "/". Ini menghasilkan posisi dipindahkan ke karakter berikutnya, yang dalam contoh ini adalah posisi keempat, elemen masking 9.

  • Pengguna dapat memasukkan karakter yang dapat diedit berikutnya, yang dalam contoh ini adalah digit. Digit akan divalidasi dan posisi saat ini akan secara otomatis dipindahkan ke posisi kelima, yang merupakan elemen masking 0.

Jika SkipLiterals adalah false, maka hanya input data yang valid yang diizinkan, yang dalam contoh ini akan menjadi digit.

Berlaku untuk

Lihat juga