TextField.restrict

Disponibilidad

Flash Player 6.

Sintaxis

my_txt.restrict

Descripción

Propiedad; indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. Si el valor de la propiedad restrict es null, se puede introducir cualquier carácter. Si el valor de la propiedad restrict es una cadena vacía, no se puede introducir ningún carácter. Si el valor de la propiedad restrict es una cadena de caracteres, sólo puede introducir los caracteres de la cadena en el campo de texto. La cadena se explora de izquierda a derecha. Puede especificarse un intervalo utilizando un guión (-). De este modo sólo se limita la interacción del usuario; un script puede introducir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con las casillas de verificación de Incorporar contornos de fuentes del inspector de propiedades.

Si la cadena empieza por ^, inicialmente se aceptan todos los caracteres y los caracteres posteriores de la cadena se excluyen del conjunto de caracteres aceptados. Si la cadena no empieza por ^, inicialmente no se acepta ningún carácter y los caracteres posteriores de la cadena se incluyen en el conjunto de caracteres aceptados.

Ejemplo

En el ejemplo siguiente sólo se pueden introducir caracteres en mayúsculas, espacios y números en los campos de texto:

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

En el ejemplo siguiente se incluyen todos los caracteres, pero se excluyen las letras minúsculas:

my_txt.restrict = "^a-z";

Para introducir los caracteres ^ o -, utilice una barra inversa. Las secuencias aceptadas con barra inversa son \-, \^ y \\. La barra inversa debe ser un carácter real de la cadena, de modo que cuando se especifique en ActionScript, deben utilizarse dos. Por ejemplo, el código siguiente incluye sólo el guión (-) y el carácter de intercalación (^):

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

El carácter ^ puede utilizarse en cualquier posición de la cadena para alternar la inclusión y la exclusión de caracteres. El código siguiente incluye sólo letras mayúsculas, pero excluye la letra mayúscula Q:

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

Puede utilizar la secuencia de escape \u para crear cadenas restrict. El código siguiente incluye sólo los caracteres comprendidos entre ASCII 32 (espacio) y ASCII 126 (tilde).

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