MaskedTextBox.SkipLiterals Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece un valor que indica si el usuario puede volver a especificar valores literales.

public:
 property bool SkipLiterals { bool get(); void set(bool value); };
public bool SkipLiterals { get; set; }
member this.SkipLiterals : bool with get, set
Public Property SkipLiterals As Boolean

Valor de propiedad

Boolean

Es true para permitir que se vuelvan a especificar literales; de lo contrario, es false para impedir que el usuario sobrescriba literales de cadena. De manera predeterminada, es true.

Comentarios

Las máscaras de entrada suelen contener literales. Cuando el usuario escribe caracteres en en MaskedTextBox tiempo de ejecución, la posición del carácter actual a veces caerá en un literal. La SkipLiterals propiedad describe cómo se va a controlar la entrada del usuario para el siguiente carácter, como se indica a continuación:

  • Si esta propiedad es true, el usuario puede escribir redundantemente el mismo carácter que el literal en la posición actual o puede escribir el siguiente carácter editable, saltando así la posición actual a esa posición.

  • Si esta propiedad es false, el usuario solo puede escribir el siguiente carácter editable. Si la siguiente posición de la máscara no aceptará el carácter literal (por ejemplo, el usuario escribe "/" y la siguiente posición solo acepta dígitos), el control generará el MaskInputRejected evento.

Por ejemplo, en la máscara de entrada de fecha "90/90/0000", los caracteres de barra diagonal son literales. Supongamos que el usuario ha escrito dos dígitos iniciales, "11", por lo que la posición actual de la máscara está en el primer literal de barra diagonal (/). Si SkipLiterals es true, el usuario tiene las siguientes opciones válidas:

  • El usuario puede escribir un carácter "/". Esto da como resultado la posición que se mueve al siguiente carácter, que en este ejemplo es la cuarta posición, un elemento de enmascaramiento de 9.

  • El usuario puede escribir el siguiente carácter editable, que en este ejemplo es un dígito. El dígito se validaría y la posición actual se movería automáticamente a la quinta posición, que es un elemento de enmascaramiento 0.

Si SkipLiterals es false, solo se permite una entrada de datos válida, que en este ejemplo sería un dígito.

Se aplica a

Consulte también