Panduan: Bekerja dengan MaskedTextBox Control

Artikel
10/19/2023

Tugas yang diilustrasikan dalam panduan ini meliputi:

Menginisialisasi MaskedTextBox kontrol
Menggunakan penanganan MaskInputRejected aktivitas untuk memperingatkan pengguna ketika karakter tidak sesuai dengan masker
Menetapkan jenis ke ValidatingType properti dan menggunakan TypeValidationCompleted penanganan aktivitas untuk memperingatkan pengguna ketika nilai yang mereka coba terapkan tidak valid untuk jenis tersebut

Membuat Proyek dan Menambahkan Kontrol

Untuk menambahkan kontrol MaskedTextBox ke formulir Anda

Buka formulir tempat Anda ingin menempatkan MaskedTextBox kontrol.
MaskedTextBox Seret kontrol dari Kotak Alat ke formulir Anda.
Klik kanan kontrol dan pilih Properti. Di jendela Properti , pilih properti Mask dan klik tombol ... (elipsis) di samping nama properti.
Dalam kotak dialog Masker Input, pilih masker Tanggal Pendek dan klik OK.
Di jendela Properti atur properti ke BeepOnErrortrue. Properti ini menyebabkan bunyi bip singkat setiap kali pengguna mencoba memasukkan karakter yang melanggar definisi masker.

Untuk ringkasan karakter yang didukung properti Mask, lihat bagian Keterangan properti Mask .

Memperingatkan Pengguna untuk Kesalahan Input

Menambahkan tip balon untuk input masker yang ditolak

Kembali ke Kotak Alat dan tambahkan ToolTip ke formulir Anda.

Buat penanganan aktivitas untuk MaskInputRejected peristiwa yang memunculkan ToolTip saat terjadi kesalahan input. Ujung balon tetap terlihat selama lima detik, atau hingga pengguna mengkliknya.

public void Form1_Load(Object sender, EventArgs e)
{  
    ... // Other initialization code  
    maskedTextBox1.Mask = "00/00/0000";  
    maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected)  
}  

void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e)  
{  
    toolTip1.ToolTipTitle = "Invalid Input";  
    toolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", maskedTextBox1, maskedTextBox1.Location, 5000);  
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load  
    Me.ToolTip1.IsBalloon = True  
    Me.MaskedTextBox1.Mask = "00/00/0000"  
End Sub  

Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected  
    ToolTip1.ToolTipTitle = "Invalid Input"  
    ToolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", MaskedTextBox1, 5000)  
End Sub

Memperingatkan Pengguna ke Tipe yang Tidak Valid

Menambahkan tip balon untuk tipe data yang tidak valid

Di penanganan aktivitas formulir Load Anda, tetapkan objek yang Type mewakili DateTime jenis ke MaskedTextBox properti kontrol ValidatingType :

private void Form1_Load(Object sender, EventArgs e)  
{  
    // Other code  
    maskedTextBox1.ValidatingType = typeof(System.DateTime);  
    maskedTextBox1.TypeValidationCompleted += new TypeValidationEventHandler(maskedTextBox1_TypeValidationCompleted);  
}

Private Sub Form1_Load(sender as Object, e as EventArgs)  
    // Other code  
    MaskedTextBox1.ValidatingType = GetType(System.DateTime)  
End Sub

Menambahkan penanganan aktivitas untuk peristiwa TypeValidationCompleted:

public void maskedTextBox1_TypeValidationCompleted(object sender, TypeValidationEventArgs e)  
{  
    if (!e.IsValidInput)  
    {  
       toolTip1.ToolTipTitle = "Invalid Date Value";  
       toolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000);  
       e.Cancel = true;  
    }  
}

Public Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs)  
    If Not e.IsValidInput Then  
       ToolTip1.ToolTipTitle = "Invalid Date Value"  
       ToolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000)  
       e.Cancel = True  
    End If  
End Sub

Bagikan melalui