MaskedTextBox.MaskInputRejected Olay
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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;public event System.Windows.Forms.MaskInputRejectedEventHandler? MaskInputRejected;member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler Olay Türü
Örnekler
Aşağıdaki kod örneğinde bu üyenin kullanımı gösterilmektedir. Örnekte, olay işleyicisi olayın oluşumunu MaskInputRejected bildirir. 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 MessageBox.Show değiştirmeyi Console.WriteLine veya çok satırlı TextBoxbir iletiye eklemeyi göz önünde bulundurun.
Örnek kodu çalıştırmak için, adlı MaskedTextBoxtürünün MaskedTextBox1 bir örneğini 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 varsayılan olaydır MaskedTextBox .
Olay, MaskInputRejected giriş maskesi tarafından bir karakter 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 oluşturulur:
Giriş karakteri karşılık gelen biçim öğesiyle eşleşmiyor. Örneğin, bir basamak gerektiğinde kullanıcı alfabetik bir karakter girer. Bu olayın tetiklenme nedeni muhtemelen en yaygın olan budur.
Maske zaten doldurulmuş olduğundan 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 IsOverwriteMode
false, var olan karakterleri biçim öğeleriyle eşleşmedikleri 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.
