T > TextField.restrict

TextField.restrict

Disponibilité

Flash Player 6.

Usage

monChampDeTexte.restrict

Description

Propriété ; indique le jeu de caractères qu'un utilisateur peut rentrer dans le champ de texte. Si la valeur de la propriété restrict est null, vous pouvez entrer n'importe quel caractère. Si la valeur de la propriété restrict est une chaîne vide, vous ne pouvez entrer aucun caractère. Si la valeur de la propriété restrict est une chaîne de caractères, vous ne pouvez entrer que les caractères de la chaîne dans le champ de texte. La chaîne est lue de gauche à droite. Une plage peut être spécifiée en utilisant un tiret (-). Ceci limite seulement l'interaction avec l'utilisateur, un script pouvant mettre n'importe quel texte dans le champ de texte. Cette propriété ne se synchronise pas avec les cases à cocher de polices vectorielles intégrées de l'inspecteur des propriétés.

Si la chaîne commence par un caret (^), tous les caractères sont initialement acceptés et les caractères suivants de la chaîne sont exclus du jeu de caractères acceptés. Si la chaîne ne commence pas par un caret (^), aucun caractère n'est initialement accepté et les caractères suivants de la chaîne sont inclus dans le jeu de caractères acceptés.

Exemple

L'exemple suivant permet seulement que des caractères majuscules, des espaces et des nombres soient entrés dans un champ de texte :

mon_txt.restrict = "A-Z 0-9";

L'exemple suivant comprend tous les caractères, mais exclut les lettres minuscules :

mon_txt.restrict = "^a-z"; 

Vous pouvez utiliser une barre oblique inverse pour entrer un ^ ou - textuellement. Les séquences de barre oblique inverse acceptées sont \-, \^ ou \\. La barre oblique inverse doit être effectivement un caractère de la chaîne ; aussi, pour le spécifier dans ActionScript, une double barre oblique inverse doit être utilisée. Par exemple, le code suivant inclut uniquement le tiret (-) et le caret (^) :

mon_txt.restrict = "\\-\\^";

Le caret (^) peut être utilisé n'importe où dans la chaîne pour alterner entre l'inclusion de caractères et l'exclusion de caractères. Le code suivant inclut seulement les lettres majuscules, mais exclut la lettre majuscule Q :

mon_txt.restrict = "A-Z^Q"; 

Vous pouvez utiliser la séquence d'échappement \u pour construire des chaînes restrict. Le code suivant inclut seulement les caractères compris entre le code ASCII 32 (espace) et le code ASCII 126 (tilde).

mon_txt.restrict = "\u0020-\u007E";