Propiedad Máscara de entrada
Utilice la propiedad Máscara de entrada para especificar una máscara que se aplique al texto introducido en un componente (como un número de teléfono). Una máscara sirve de modelo para el texto.
Caracteres máscara
| Carácter | Nº curso |
|---|---|
| > | Marcador de posición de dígitos (0-9). El carácter de solicitud está en blanco. Se aplica a tipos de datos numéricos. |
| 9 | Marcador de posición de dígitos (0-9). El carácter de solicitud es 0. Se aplica a tipos de datos numéricos. Las máscaras con 9 no son compatibles con los valores Nulo (consulte Notas de uso). |
| Z | Marcador de posición de dígitos (0-9). El carácter de solicitud está en blanco y el separador de millar no se aplica. Se aplica a tipos de datos numéricos. |
| < | Marcador de posición de dígitos para posiciones decimales (0-9). El carácter de solicitud está en blanco. Elimina los ceros finales no significativos. Se aplica a tipos de datos numéricos. |
| # | Marcador de posición de dígitos (0-9). El carácter de solicitud está en blanco. Se aplica a tipos de datos numéricos.
Nota: Esto está disponible sólo para la compatibilidad con versiones anteriores y generalmente no se utiliza.
|
| - | Marcador de posición de signo negativo. Se aplica a tipos de datos numéricos. |
| . | Marcador de posición decimal. Este carácter se trata como un literal en la máscara. Se aplica a tipos de datos numéricos.
El carácter real utilizado es el especificado en su configuración regional (consulte Notas de uso). |
| , | Separador de millar. Este carácter se trata como un literal en la máscara. Se aplica a tipos de datos numéricos.
El carácter real utilizado es el especificado en su configuración regional. No es necesario que especifique un separador de millar. |
| : | Separador de hora. Este carácter se trata como un literal en la máscara. Se aplica al tipo de datos de DATE.
El carácter real utilizado es el especificado como separador en su configuración regional. |
| A | Marcador de posición de caracteres alfanuméricos (0-9 y a-Z). Se aplica a tipo de datos CHAR. |
| ? | Marcador de posición alfabético (a-Z). Se aplica a tipo de datos CHAR. |
| X | Marcador de posición alfabético que obliga a los caracteres a letras mayúsculas (A-Z). Se aplica a tipo de datos CHAR. |
| x | Marcador de posición alfabético que obliga a los caracteres a letras minúsculas (a-z). Se aplica a tipo de datos CHAR. |
| & | Marcador de posición de carácter. Los valores válidos para este marcador de posición son caracteres ANSI en los rangos siguientes: 32-126 y 128-255. Se aplica a tipo de datos CHAR. |
| \ | Escape literal.
Para tratar cualquiera de los caracteres anteriores como literales, utilice una barra invertida que preceda al carácter. |
| [NONE] | No se aplica una máscara. |
Notas de uso:
-
Nulo: Una máscara numérica que contiene 9 no es compatible con valores Nulo; debe transferir algún valor al componente. La máscara consulta Nulo como 0. La supresión
o retroceso de un valor en un componente produce 0. Pegar desde el portapapeles produce 0. Si un componente con la máscara
no es obligatorio y no tiene valor predeterminado, el valor del componente en una nueva fila muestra inicialmente 0 y puede
guardarse como 0 si no se ha introducido ningún valor.
Una máscara numérica que no contiene 9 es compatible con valores Nulo; puede actualizar el componente con un valor Nulo o en blanco. La máscara consulta Nulo como una cadena vacía. La supresión o retroceso de un valor o pegar desde el portapapeles genera una cadena vacía. Si no se requiere un componente con la máscara y no tiene ningún valor predeterminado, el valor del componente en una nueva fila en la que no se introduce ningún valor en el componente se puede guardar como Nulo.
- [NONE]: La configuración [NONE] elimina cualquier máscara heredada de una clase de componente, una extensión de clase de propiedad u otro objeto de la jerarquía de herencia.
- Separadores de millar: Las definiciones de máscara no tienen que especificar separadores de millar (por ejemplo, comas). Estos separadores se configuran automáticamente utilizando el símbolo decimal y las definiciones de símbolos de agrupación de dígitos en el cuadro de diálogo Opciones regionales del panel de control de Windows.
- Moneda: Las clases que representan datos de moneda en el sistema utilizan como valores predeterminados los valores en el cuadro de diálogo Opciones regionales del panel de control de Windows especificado para los números, no los valores especificados para la moneda.
- Redondeo: Si la propiedad Redondear es Verdadero, WinStudio redondea utilizando la máscara de definición de posiciones decimales.
- Supresión de los ceros finales: Para valores decimales cuya máscara incluye el carácter <, el valor se muestra con los ceros finales no significativos eliminados.
Ejemplo
Si la máscara está establecida en >>>>>9.99 < < y el usuario introduce 12345,125000, el valor se muestra como 12.345,125. Este formateo se produce después de que el cursor abandona el campo.