Tutorial: Trabajar con el control MaskedTextBox

Artículo
05/04/2023

Las tareas ilustradas en este tutorial incluyen:

Inicializar el control MaskedTextBox
Usar el controlador de eventos MaskInputRejected para alertar al usuario cuando un carácter no se ajuste a la máscara
Asignar un tipo a la propiedad ValidatingType y usar el controlador de eventos TypeValidationCompleted para alertar al usuario cuando el valor que intenta confirmar no es válido para el tipo

Creación del proyecto y adición de un control

Para agregar un control MaskedTextBox al formulario

Abra el formulario en el que desea colocar el control MaskedTextBox.
Arrastre un control MaskedTextBox del cuadro de herramientas al formulario.
Haga clic con el botón derecho en el control y seleccione Propiedades. En la ventana Propiedades, seleccione la propiedad Mask y haga clic en el botón ... (puntos suspensivos) situado junto al nombre de la propiedad.
En el cuadro de diálogo Máscara de entrada, seleccione la máscara Fecha corta y haga clic en Aceptar.
En la ventana Propiedades, establezca la propiedad BeepOnError en true. Esta propiedad hace que un breve pitido suene cada vez que el usuario intente introducir un carácter que infringe la definición de máscara.

Para obtener un resumen de los caracteres que admite la propiedad Mask, vea la sección Comentarios de la propiedad Mask.

Alerta al usuario de errores de entrada

Adición de un globo de sugerencias de una entrada de máscara rechazada

Vuelva al cuadro de herramientas y agregue un elemento ToolTip al formulario.

Cree un controlador de eventos relativo al evento MaskInputRejected que genere ToolTip cuando se produzca un error de entrada. El globo de sugerencias permanece visible durante cinco segundos o hasta que se hace clic en él.

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

Alerta al usuario de un tipo que no es válido

Adición de un globo de sugerencias de tipos de datos no válidos

En el controlador de eventos Load del formulario, asigne un objeto Type que represente el tipo DateTime a la propiedad ValidatingType del control MaskedTextBox:

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

Agregue un controlador de eventos para el 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