MaskedTextBox.SkipLiterals Propiedad

Definición

Obtiene o establece un valor que indica si el usuario puede volver a especificar valores literales.Gets or sets a value indicating whether the user is allowed to reenter literal values.

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

Es true para permitir que se vuelvan a especificar literales; de lo contrario, es false para impedir que el usuario sobrescriba literales de cadena.true to allow literals to be reentered; otherwise, false to prevent the user from overwriting literal characters. El valor predeterminado es true.The default is true.

Comentarios

Las máscaras de entrada suelen contener literales.Input masks commonly contain literals. Cuando el usuario escribe caracteres en el MaskedTextBox en tiempo de ejecución, la posición del carácter actual a veces se encontrará en un literal.When the user enters characters into the MaskedTextBox at runtime, the current character position will sometimes fall on a literal. La propiedad SkipLiterals describe cómo se debe controlar la entrada del usuario para el siguiente carácter, como se indica a continuación:The SkipLiterals property describes how user input for the next character is to be handled, as follows:

  • Si esta propiedad es true, el usuario puede escribir de forma redundante el mismo carácter que el literal en la posición actual, o bien puede escribir el siguiente carácter modificable, con lo que se salta la posición actual a esa posición.If this property is true, the user can either redundantly enter the same character as the literal at the current position, or can enter the next editable character, thereby jumping the current position to that position.

  • Si esta propiedad es false, el usuario solo puede escribir el siguiente carácter modificable.If this property is false, the user can only enter the next editable character. Si la siguiente posición de la máscara no va a aceptar el carácter literal (por ejemplo, los tipos de usuario "/" y la posición siguiente solo acepta dígitos), el control generará el evento MaskInputRejected.If the next position in the mask will not accept the literal character (for example, the user types "/" and the next position only accepts digits), the control will raise the MaskInputRejected event.

Por ejemplo, en la máscara de entrada de fecha "90/90/0000", los caracteres de barra diagonal son literales.As an example, in the "90/90/0000" date entry mask, the forward slash characters are literals. 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 (/).Assume that the user has entered two initial digits, "11", so the current position in the mask is at the first forward slash (/) literal. Si SkipLiterals se true, el usuario tiene las siguientes opciones válidas:If SkipLiterals is true, then the user has the following valid choices:

  • El usuario puede escribir un carácter "/".The user can enter a "/" character. Esto hace que la posición se mueva al siguiente carácter, que en este ejemplo es la cuarta posición, un elemento de enmascaramiento 9.This results in the position being moved to the next character, which in this example is the fourth position, a 9 masking element.

  • El usuario puede escribir el siguiente carácter modificable, que en este ejemplo es un dígito.The user can enter the next editable character, which in this example is a digit. 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.The digit would be validated and the current position would automatically be moved to the fifth position, which is a 0 masking element.

Si SkipLiterals es false, solo se permite una entrada de datos válida, que en este ejemplo sería un dígito.If SkipLiterals is false, then only a valid data input is allowed, which in this example would be a digit.

Se aplica a

Consulte también: