MaskedTextBox.MaskInputRejected Событие

Определение

Происходит в том случае, если назначенный или введенный пользователем знак не совпадает с соответствующим элементом формата маски ввода.Occurs when the user's input or assigned character does not match the corresponding format element of the input mask.

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 

Тип события

MaskInputRejectedEventHandler

Примеры

В следующем примере кода показано использование этого элемента.The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении MaskInputRejected события.In the example, an event handler reports on the occurrence of the MaskInputRejected event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox .To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа MaskedTextBox с именем MaskedTextBox1 .To run the example code, paste it into a project that contains an instance of type MaskedTextBox named MaskedTextBox1. Затем убедитесь, что обработчик событий связан с MaskInputRejected событием.Then ensure that the event handler is associated with the MaskInputRejected event.

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 is the default event for the MaskedTextBox class.

Это MaskInputRejected событие возникает, когда символ отклоняется маской ввода.The MaskInputRejected event occurs when a character is rejected by the input mask. Маска ввода, представленная Mask свойством, интерпретируется поставщиком маскированного текста, связанным с элементом управления через MaskedTextProvider свойство.The input mask, represented by the Mask property, is interpreted by the masked text provider associated with the control through the MaskedTextProvider property. MaskInputRejected возникает в следующих ситуациях:MaskInputRejected is raised in the following situations:

  • Входной символ не соответствует соответствующему элементу форматирования.An input character does not match the corresponding format element. Например, если требуется цифра, пользователь вводит алфавитный символ.For example, the user enters an alphabetic character when a digit is required. Скорее всего, это наиболее распространенная причина возникновения этого события.This is probably the most common reason why this event is raised.

  • Пользователь пытается ввести лишние символы за пределами маски либо потому, что маска уже заполнена, либо текущая позиции курсора была перемещена в конец отображаемой строки маски ввода.The user is trying to input extraneous characters beyond the end of the mask either because the mask has already been filled or the current caret position has been moved to the very end of the displayed input mask string.

  • Операция вставки либо вставляет символ, не соответствующий связанному с ним элементом форматирования, либо IsOverwriteMode , если свойство имеет значение false , сдвигает существующие символы в новые позиции, в которых они не соответствуют элементам формата.A paste operation either inserts a character that does not match its associated format element, or if the IsOverwriteMode property is false, it shifts existing characters into new positions where they do not match their format elements.

  • Операция вырезания сдвигает существующие символы влево, а один или несколько символов не соответствуют вновь связанным элементам формата.A cut operation shifts existing characters to the left, and one or more characters do not match their newly associated format elements.

  • Присвоение значения Text свойству и присвоенная строка привела к одному или нескольким нарушениям маски.An assignment was made to the Text property and the assigned string caused one or more mask violations.

Если строка была назначена элементу управления, который вызывается MaskInputRejected , то ни одна часть строки не будет отображаться в MaskedTextBox .If a string was assigned to the control that causes MaskInputRejected to occur, no part of the string will appear in MaskedTextBox.

Обработка по умолчанию для MaskInputRejected будет воспроизводить звуковой сигнал, если BeepOnError свойство имеет значение true .The default handling for MaskInputRejected will play a beep sound if the BeepOnError property is set to true. Это событие часто обрабатывается для реализации пользовательской обработки ошибок, например, для перехода к следующему пользовательскому элементу управления вводом, если маска заполнена, или для вывода пользовательского диалогового окна ошибки или всплывающей подсказки, если входной символ является недопустимым.This event is often handled to implement custom error handling, for example, to move to the next user input control if the mask is full, or to display a custom error dialog box or ToolTip if the input character is invalid.

Применяется к

См. также раздел