MaskedTextBox.SkipLiterals Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property SkipLiterals As BooleanValeur 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.
