Partager via


MaskedTextBox.SkipLiterals Propriété

Définition

Obtient ou définit une valeur indiquant si l'utilisateur est autorisé à entrer à nouveau des valeurs littérales.

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

Valeur de propriété

true pour autoriser que des littéraux soient à nouveau entrés ; sinon, false pour empêcher l'utilisateur de remplacer des caractères de type littéral. La valeur par défaut est true.

Remarques

Les masques d’entrée contiennent généralement des littéraux. Lorsque l’utilisateur entre des caractères dans au moment de l’exécution MaskedTextBox , la position actuelle du caractère tombe parfois sur un littéral. La SkipLiterals propriété décrit comment l’entrée utilisateur pour le caractère suivant doit être gérée, comme suit :

  • Si cette propriété est true, l’utilisateur peut entrer de manière redondante le même caractère que le littéral à la position actuelle, ou entrer le caractère modifiable suivant, faisant ainsi sauter la position actuelle à cette position.

  • Si cette propriété est false, l’utilisateur peut uniquement entrer le caractère modifiable suivant. Si la position suivante du masque n’accepte pas le caractère littéral (par exemple, l’utilisateur tape « / » et la position suivante accepte uniquement les chiffres), le contrôle déclenche l’événement MaskInputRejected .

Par exemple, dans le masque d’entrée de date « 90/90/0000 », les caractères de barre oblique sont des littéraux. Supposons que l’utilisateur a entré deux chiffres initiaux, « 11 », de sorte que la position actuelle dans le masque se trouve au premier littéral de barre oblique (/). Si SkipLiterals est true, l’utilisateur dispose des options valides suivantes :

  • L’utilisateur peut entrer un caractère « / ». Cela entraîne le déplacement de la position vers le caractère suivant, qui dans cet exemple est la quatrième position, un élément de masquage 9.

  • L’utilisateur peut entrer le caractère modifiable suivant, qui dans cet exemple est un chiffre. Le chiffre est validé et la position actuelle est automatiquement déplacée vers la cinquième position, qui est un élément de masquage 0.

Si SkipLiterals est false, seule une entrée de données valide est autorisée, qui dans cet exemple serait un chiffre.

S’applique à

Voir aussi