Пошаговое руководство. Работа с элементом управления MaskedTextBox

В данном пошаговом руководстве представлены следующие задачи.

• Инициализация MaskedTextBox элемента управления

• С помощью MaskInputRejected обработчик событий для оповещения пользователя, когда символ не соответствует маске

• Присвоение типа ValidatingType свойство и с помощью TypeValidationCompleted обработчик событий для оповещения пользователя, когда он пытается зафиксировать значение недопустимо для типа

Создание проекта и добавление элемента управления

Для добавления в форму элемент управления MaskedTextBox

1. Откройте форму, на котором вы хотите поместить MaskedTextBox элемента управления.

2. Перетащите MaskedTextBox управления из элементов в форму.

3. Щелкните правой кнопкой мыши элемент управления и выберите свойства. В свойства выберите маска свойство и нажмите кнопку ... (многоточие) рядом с именем свойства.

4. В маска ввода выберите короткого формата даты замаскированы, а затем нажмите кнопку ОК.

5. В свойства задайте BeepOnError свойства true. Это свойство создает короткий звуковой сигнал всякий раз пользователь пытается ввести знак, не соответствует определению маски.

Сводка символы, которые поддерживает свойство маски, см. в разделе "Примечания" Mask свойство.

Оповещать пользователя об ошибках ввода

Добавьте всплывающую подсказку об отклоненном вводе

1. Вернитесь к элементов и добавьте ToolTip в форму.

2. Создайте обработчик событий для MaskInputRejected событие, которое вызывает ToolTip при возникновении ошибки ввода. Всплывающая подсказка остается видимым, в течение пяти секунд, или пока пользователь не щелкнет его.

   public void Form1_Load(Object sender, EventArgs e)   
   {  
       ... // Other initialization code  
       maskedTextBox1.Mask = "00/00/0000";  
       maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected)  
   }  
   
   void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e)  
   {  
       toolTip1.ToolTipTitle = "Invalid Input";  
       toolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", maskedTextBox1, maskedTextBox1.Location, 5000);  
   }  
   

   Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load  
       Me.ToolTip1.IsBalloon = True  
       Me.MaskedTextBox1.Mask = "00/00/0000"  
   End Sub  
   
   Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected  
       ToolTip1.ToolTipTitle = "Invalid Input"  
       ToolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", MaskedTextBox1, 5000)  
   End Sub  
   

Предупредить пользователя к типу, который является недопустимым

Добавьте всплывающую подсказку для недопустимые типы данных

1. В вашей форме Load обработчик событий, назначить Type объект, представляющий DateTime тип MaskedTextBox элемента управления ValidatingType свойство:

   private void Form1_Load(Object sender, EventArgs e)  
   {  
       // Other code  
       maskedTextBox1.ValidatingType = typeof(System.DateTime);  
       maskedTextBox1.TypeValidationCompleted += new TypeValidationEventHandler(maskedTextBox1_TypeValidationCompleted);  
   }  
   

   Private Sub Form1_Load(sender as Object, e as EventArgs)  
       // Other code  
       MaskedTextBox1.ValidatingType = GetType(System.DateTime)  
   End Sub  
   

2. Добавьте обработчик событий для события TypeValidationCompleted.

   public void maskedTextBox1_TypeValidationCompleted(object sender, TypeValidationEventArgs e)  
   {  
       if (!e.IsValidInput)  
       {  
          toolTip1.ToolTipTitle = "Invalid Date Value";  
          toolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000);  
          e.Cancel = true;  
       }  
   }  
   

   Public Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs)  
       If Not e.IsValidInput Then  
          ToolTip1.ToolTipTitle = "Invalid Date Value"  
          ToolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000)  
          e.Cancel = True  
       End If  
   End Sub  
   

См. также

• MaskedTextBox
• Элемент управления MaskedTextBox