MaskedTextBox.MaskInputRejected Kejadian

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Terjadi ketika input pengguna atau karakter yang ditetapkan tidak cocok dengan elemen format yang sesuai dari masker input.

public:
 event System::Windows::Forms::MaskInputRejectedEventHandler ^ MaskInputRejected;

public event System.Windows.Forms.MaskInputRejectedEventHandler? MaskInputRejected;

member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler 

Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler 

Jenis Acara

MaskInputRejectedEventHandler

Contoh

Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, penanganan aktivitas melaporkan terjadinya MaskInputRejected peristiwa. Laporan ini membantu Anda mempelajari kapan peristiwa terjadi dan dapat membantu Anda dalam penelusuran kesalahan. Untuk melaporkan beberapa peristiwa atau pada peristiwa yang sering terjadi, pertimbangkan untuk mengganti MessageBox.Show dengan Console.WriteLine atau menambahkan pesan ke multibaris TextBox.

Untuk menjalankan kode contoh, tempelkan ke dalam proyek yang berisi instans jenis MaskedTextBox bernama MaskedTextBox1. Kemudian pastikan bahwa penanganan aktivitas dikaitkan dengan MaskInputRejected peristiwa.

private void MaskedTextBox1_MaskInputRejected(Object sender, MaskInputRejectedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Position", e.Position );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MaskInputRejected Event" );
}

Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) _ 
     Handles MaskedTextBox1.MaskInputRejected

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Position", e.Position)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MaskInputRejected Event")

End Sub

Keterangan

MaskInputRejected adalah peristiwa default untuk MaskedTextBox kelas .

Peristiwa terjadi MaskInputRejected ketika karakter ditolak oleh masker input. Masker input, yang diwakili oleh Mask properti , ditafsirkan oleh penyedia teks bertopeng yang terkait dengan kontrol melalui MaskedTextProvider properti . MaskInputRejected dimunculkan dalam situasi berikut:

• Karakter input tidak cocok dengan elemen format yang sesuai. Misalnya, pengguna memasukkan karakter alfabet saat digit diperlukan. Ini mungkin alasan paling umum mengapa peristiwa ini diangkat.

• Pengguna mencoba memasukkan karakter asing di luar akhir masker baik karena masker telah diisi atau posisi caret saat ini telah dipindahkan ke bagian paling akhir string masker input yang ditampilkan.

• Operasi tempel menyisipkan karakter yang tidak cocok dengan elemen format terkait, atau jika IsOverwriteMode properti adalah false, operasi ini menggeser karakter yang ada ke posisi baru di mana mereka tidak cocok dengan elemen formatnya.

• Operasi potong menggeser karakter yang ada ke kiri, dan satu atau beberapa karakter tidak cocok dengan elemen format yang baru dikaitkan.

• Penugasan dilakukan ke Text properti dan string yang ditetapkan menyebabkan satu atau beberapa pelanggaran masker.

Jika string ditetapkan ke kontrol yang menyebabkan MaskInputRejected terjadi, tidak ada bagian dari string yang akan muncul di MaskedTextBox.

Penanganan default untuk MaskInputRejected akan memutar bunyi bip jika BeepOnError properti diatur ke true. Kejadian ini sering ditangani untuk menerapkan penanganan kesalahan kustom, misalnya, untuk berpindah ke kontrol input pengguna berikutnya jika masker penuh, atau untuk menampilkan kotak dialog kesalahan kustom atau TipsAlat jika karakter input tidak valid.

Lihat juga

• Text
• Mask
• MaskedTextProvider
• MaskInputRejectedEventArgs
• IsOverwriteMode
• BeepOnError