Passo a passo: trabalhando com o controle MaskedTextBox

2025-05-07

As tarefas ilustradas neste passo a passo incluem:

Inicializando o controle MaskedTextBox
Usando o manipulador de eventos MaskInputRejected para alertar o usuário quando um caractere não estiver em conformidade com a máscara
Atribuir um tipo à propriedade ValidatingType e usar o manipulador de eventos TypeValidationCompleted para alertar o usuário quando o valor que ele está tentando confirmar não é válido para o tipo

Criando o projeto e adicionando um controle

Para adicionar um controle MaskedTextBox ao seu formulário

Abra o formulário no qual você deseja colocar o controle MaskedTextBox.
Arraste um controle MaskedTextBox da caixa de ferramentas para seu formulário.
Clique com o botão direito do mouse no controle e escolha Propriedades. Na janela Propriedades, selecione a propriedade Máscara e clique no botão de reticências ... ao lado do nome da propriedade.
Na caixa de diálogo Máscara de Entrada, selecione a máscara Data abreviada e clique em OK.
Na janela Propriedades , defina a propriedade BeepOnError como true. Essa propriedade faz com que um bipe curto soe sempre que o usuário tenta inserir um caractere que viola a definição de máscara.

Para ver um resumo dos caracteres com suporte na propriedade Máscara, consulte a seção Comentários da propriedade Mask.

Alertar o usuário para erros de entrada

Adicionar uma dica de balão para entrada de máscara rejeitada

Retorne à caixa de ferramentas e adicione um ToolTip ao seu formulário.

Crie um manipulador de eventos para o evento MaskInputRejected que gera a ToolTip quando ocorre um erro de entrada. A ponta do balão permanece visível por cinco segundos ou até que o usuário clique nela.

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 sobre um tipo que não é válido

Adicionar uma dica de balão para tipos de dados inválidos

No manipulador de eventos Load do formulário, atribua um objeto Type que representa o tipo DateTime à propriedade MaskedTextBox do controle 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

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

Compartilhar via