MaskedTextBox.MaskInputRejected Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда входной или назначенный символ пользователя не соответствует соответствующему элементу формата маски ввода.
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 Тип события
Примеры
В следующем примере кода демонстрируется использование этого элемента. В этом примере обработчик событий сообщает о возникновении MaskInputRejected события. Этот отчет поможет вам узнать, когда происходит событие, и помочь вам в отладке. Чтобы сообщить о нескольких событиях или событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine или добавить сообщение в многостроочное TextBox.
Чтобы запустить пример кода, вставьте его в проект, содержащий экземпляр типа MaskedTextBox с именем MaskedTextBox1. Затем убедитесь, что обработчик событий связан с событием MaskInputRejected .
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
Комментарии
MaskInputRejected — это событие по умолчанию для MaskedTextBox класса.
Событие MaskInputRejected возникает, когда символ отклоняется маской ввода. Маска ввода, представленная Mask свойством, интерпретируется маскируемым текстовым поставщиком, связанным с элементом управления через MaskedTextProvider свойство. MaskInputRejected вызывается в следующих ситуациях:
Входной символ не соответствует соответствующему элементу формата. Например, пользователь вводит алфавитный символ, когда требуется цифра. Это, вероятно, самая распространенная причина, почему это событие вызывается.
Пользователь пытается ввести лишние символы за пределами маски либо из-за того, что маска уже заполнена, либо текущая позиция курсора была перемещена в самую конец отображаемой строки маски ввода.
Операция вставки либо вставляет символ, который не соответствует связанному элементу формата, либо IsOverwriteMode если свойство имеет
falseзначение, оно перемещает существующие символы в новые позиции, где они не соответствуют их элементам формата.Операция вырезает существующие символы слева, а один или несколько символов не соответствуют новым связанным элементам формата.
Назначение было сделано свойству Text и назначенная строка вызвала одно или несколько нарушений маски.
Если строка была назначена элементу управления, который вызывает MaskInputRejected возникновение, ни в какой части строки не будет отображаться MaskedTextBox.
Обработка по умолчанию MaskInputRejected будет воспроизводить звуковой сигнал, если BeepOnError для свойства задано trueзначение . Это событие часто обрабатывается для реализации пользовательской обработки ошибок, например для перехода к следующему элементу управления входных данных пользователя, если маска заполнена, или для отображения настраиваемого диалогового окна ошибки или подсказки, если входной символ недопустим.
