Demonstra Passo a passo: Trabalhando com o controle MaskedTextBox
Tarefas ilustradas nesta explicação passo a passo incluem:
Inicializando o MaskedTextBox controle
Usando o MaskInputRejected manipulador de eventos para alertar o usuário quando um caractere não está de acordo com a máscara
Atribuindo um tipo para o ValidatingType propriedade e usando o TypeValidationCompleted evento manipulador para alertar o usuário quando o valor que estão tentando confirmar inválido para o tipo
Para uma completa versao do MaskedTextBox controle que demonstra sistema autônomo recursos avançados, sistema autônomo validação usando tipos de dados personalizados, consulte Exemplo de Controlarar MaskedTextBox.
Criando o projeto e adicionando um controle
Para adicionar um controle MaskedTextBox ao formulário
Abra o formulário no qual você deseja colocar o MaskedTextBox controle.
arrastar um MaskedTextBox controlar a partir do Caixa de ferramentas ao seu formulário.
clicar com o botão direito do mouse no controle e escolher Propriedades.No Propriedades janela, selecionar o Máscara propriedade e clicar no ... () botão elipse ao lado do nome da propriedade.
No Máscara de entrada diálogo, selecionar o Data abreviada máscara e clicar OK.
No Propriedades janela conjunto o BeepOnError propriedade para true. Essa propriedade causará um bipe curto de cada vez que o usuário tentar um caractere que violam a definição da máscara de entrada de som.
alerta o usuário para erros de entrada
Adicionar uma dica de balão para entrada de máscara rejeitado
Retornar para o Caixa de ferramentas and add a ToolTip ao seu formulário.
Criar um manipulador de eventos para o MaskInputRejected evento que dispara a ToolTip Quando ocorre um erro de entrada. A dica de balão permanece visível por cinco segundos ou até que o usuário clica nele.
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
Alertar o usuário para um tipo inválido
Adicionar uma dica de balão para tipos de dados inválido
No Load manipulador de eventos, atribua um Type objeto que representa o DateTime Digite para o MaskedTextBox do controle ValidatingType propriedade:
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
Adicione um manipulador de eventos para o evento 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