TextBox.Mask

TextBox

Máscara

Disponible desde la versión 8.0.

Uso:

Leer y escribir.

Descripción:

Tipo: Cadena de caracteres.
Contiene la cadena de caracteres de la máscara utilizada para ingresar texto en el cuadro de forma interactiva. La cadena de caracteres de la máscara puede incluir los siguientes caracteres especiales:

  • ! – cualquier carácter ingresado se convierte en mayúscula;
  • 9 – permite ingresar cualquier carácter numérico;
  • # – permite ingresar cualquier carácter numérico, el signo de menos (-), el signo de más (+) o un espacio;
  • N – permite ingresar cualquier carácter alfanumérico;
  • U – permite ingresar cualquier carácter alfanumérico, que se convierten automáticamente en mayúscula;
  • X – permite ingresar cualquier carácter individual;
  • ^ – este carácter no puede ser ingresado por el usuario de forma interactiva y solo se establece mediante el lenguaje;
  • h – permite ingresar dígitos hexadecimales;
  • @ – permite ingresar cualquier carácter alfanumérico en mayúscula o un espacio.

Cuando se coloca un valor del cuadro de texto de máscara en el atributo de texto asociado a este último, se convierte de la siguiente manera: en todos los lugares donde hay un carácter “@” en la máscara y un espacio en la cadena, se elimina el espacio. Si una máscara compuesta por caracteres especiales contiene solo caracteres “@”, entonces se eliminan todos los caracteres de texto que corresponden a caracteres no especiales de la máscara y que están situados después del último bloque @ no vacío. Por ejemplo, si la máscara es “@@.@@.@@.”, el texto “41. 2. .” se convierte en “41.2”.

Para usar uno de los símbolos especiales en una máscara, es necesario usar antes de él el símbolo “\”.

Se supone la instrucción de varias máscaras en un parámetro. Las máscaras se dividen por el símbolo “;”.
En este caso, se utilizará la máscara a la que se acerque el texto ingresado.

Disponibilidad:

Cliente grueso.

Nota:

Este atributo se aplica solo a valores de Cadena de caracteres.
Si la cadena ingresada en el cuadro de texto corresponde a una máscara vacía, el valor se establece como una cadena vacía.
Si un atributo utiliza una cadena de longitud fija, se agregará un espacio al valor hasta la longitud especificada.

Disponible desde:

Disponible desde la versión 8.0.