Tutorial: Trabajar con el control MaskedTextBox Home
This page is specific to:.NET Framework Version:2.03.03.5
Programación con formularios Windows Forms
Tutorial: Trabajar con el control MaskedTextBox

Las tareas ilustradas en este tutorial incluyen:

  • Inicializar el control MaskedTextBox

  • Utilizar el controlador de eventos MaskInputRejected para avisar al usuario cuando un carácter no se ajusta a la máscara

  • Asignar un tipo a la propiedad ValidatingType y utilizar el controlador de eventos TypeValidationCompleted para avisar al usuario cuando el valor que se intenta comprometer no es válido para el tipo

Para una versión completa que funcione del control MaskedTextBox que muestra las características avanzadas como la validación con tipos de datos personalizados, vea Ejemplo MaskedTextBox Control.

Crear el proyecto y agregar un control

Para agregar un control MaskedTextBox al formulario

  1. Abra el formulario en el que desea colocar el control MaskedTextBox.

  2. Arrastre un control MaskedTextBox desde el Cuadro de herramientas hasta el formulario.

  3. Haga clic con el botón secundario del mouse en el control y elija Propiedades. En la ventana Propiedades, seleccione la propiedad Mask y haga clic en el botón .... (puntos suspensivos) junto al nombre de propiedad.

  4. En el cuadro de diálogo Máscara de entrada, seleccione la máscara de Fecha corta y haga clic en Aceptar.

  5. En la ventana Propiedades, establezca la propiedad BeepOnError en true. Esta propiedad hace que suene un bip corto cada vez que el usuario intenta introducir un carácter que infringe la definición de máscara.
Avise al usuario de los errores de entrada

Agregue un globo de información para entradas de máscara rechazadas

  1. Vuelva al Cuadro de herramientas y agregue ToolTip al formulario.

  2. Cree un controlador de eventos para el evento MaskInputRejected que muestre el texto de ToolTip cuando se produce un error de entrada. El globo de información permanece visible durante cinco segundos o hasta que el usuario hace clic en él.

    Copiar al PortapapelesImprimir
    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);
}

    Copiar al PortapapelesImprimir
    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
Avise al usuario de que tipo no es válido

Agregue un globo de información para los tipos de datos no válidos

  1. En el controlador de eventos Load del formulario, asigne un objeto Type que representa el tipo DateTime en la propiedad ValidatingType del control MaskedTextBox:

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

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

  2. Agregue un controlador de eventos para el evento TypeValidationCompleted:

    Copiar al PortapapelesImprimir
    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;
    }
}

    Copiar al PortapapelesImprimir
    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
Vea también

Referencia

MaskedTextBox

Otros recursos

MaskedTextBox (Control, formularios Windows Forms)

© 2009 Microsoft Corporation. Reservados todos los derechos.   Términos de uso | Marcas Registradas | Privacidad
Page view tracker
Evalúe la versión ligera de la biblioteca
x
La versión ligera está basada en ScriptFree (ancho de banda bajo) y se han añadido características que nos han solicitado, como un cuadro de búsqueda y la selección del lenguaje de código predeterminado.
¿Le gusta el cuadro de búsqueda?
¿Le gustan los bloques de código por fichas?
¿En qué medida considera útil este tema?
Díganos algo más.
Gracias
x
Nos está ayudando a mejorar MSDN Online.
Comentarios
Cambiar vista
x
Clásica
Ligera
ScriptFree
Cambiar vista