MaskedTextBox.MaskInputRejected Olay

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kullanıcının girişi veya atanan karakteri giriş maskesinin karşılık gelen biçim öğesiyle eşleşmediğinde gerçekleşir.

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 

Olay Türü

MaskInputRejectedEventHandler

Örnekler

Aşağıdaki kod örneğinde bu üyenin kullanımı gösterilmektedir. Örnekte, olay işleyicisi olayın oluşumunu MaskInputRejected raporlar. Bu rapor, olayın ne zaman gerçekleştiğini öğrenmenize yardımcı olur ve hata ayıklamada size yardımcı olabilir. Birden çok olayı veya sık gerçekleşen olayları raporlamak için, iletisini ile Console.WriteLine değiştirmeyi MessageBox.Show veya iletiyi çok satırlı TextBoxbir iletiye eklemeyi göz önünde bulundurun.

Örnek kodu çalıştırmak için, adlı MaskedTextBox1bir tür MaskedTextBox örneği içeren bir projeye yapıştırın. Ardından olay işleyicisinin olayla ilişkilendirildiğinden MaskInputRejected emin olun.

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

Açıklamalar

MaskInputRejected sınıfı için MaskedTextBox varsayılan olaydır.

Olay, MaskInputRejected bir karakter giriş maskesi tarafından reddedildiğinde gerçekleşir. özelliğiyle Mask temsil edilen giriş maskesi, özelliği aracılığıyla MaskedTextProvider denetimle ilişkili maskelenmiş metin sağlayıcısı tarafından yorumlanır. MaskInputRejected aşağıdaki durumlarda ortaya çıkar:

• Giriş karakteri ilgili biçim öğesiyle eşleşmiyor. Örneğin, bir basamak gerektiğinde kullanıcı alfabetik bir karakter girer. Bu olayın ortaya çıkarılmış olmasının en yaygın nedeni muhtemelen budur.

• Maske zaten doldurulmuş veya geçerli şapka işareti konumu görüntülenen giriş maskesi dizesinin en sonuna taşındığından, kullanıcı maskenin sonundan fazla karakterler girmeye çalışıyor.

• Yapıştırma işlemi ilişkili biçim öğesiyle eşleşmeyen bir karakter ekler veya özelliği ise IsOverwriteModefalse, var olan karakterleri biçim öğeleriyle eşleşmeyen yeni konumlara kaydırır.

• Kesme işlemi var olan karakterleri sola kaydırıyor ve bir veya daha fazla karakter yeni ilişkili biçim öğeleriyle eşleşmiyor.

• Özelliğine Text bir atama yapıldı ve atanan dize bir veya daha fazla maske ihlaline neden oldu.

Denetime gerçekleşmesine neden MaskInputRejected olan bir dize atanmışsa, dizenin hiçbir bölümü içinde MaskedTextBoxgörünmez.

özelliği olarak ayarlanırsa BeepOnErrortrueiçin MaskInputRejected varsayılan işleme bir bip sesi çalar. Bu olay genellikle özel hata işleme uygulamak, örneğin maske doluysa bir sonraki kullanıcı giriş denetimine geçmek veya giriş karakteri geçersizse özel bir hata iletişim kutusu veya Araç İpucu görüntülemek için işlenir.

Ayrıca bkz.

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