La propiedad
validValues (antes la propiedad
range) indica un conjunto de valores válidos para la entrada de usuario. La propiedad se utiliza para campos de caracteres numéricos. El formato de la propiedad es el siguiente:
validValues = literalMatriz
- literalMatriz
- Un literal de matriz de elementos singulares y de dos valores, como en los ejemplos siguientes:
validValues = [ [1,3], 5, 12 ]
validValues = [ "a", ["bbb", "i"]]
Cada elemento singular contiene un valor
válido. Cada elemento de dos valores contiene un rango:
- Para los números, el valor situado más a la izquierda es el valor más bajo válido, el situado
más a la derecha, el más alto. En el ejemplo anterior, los valores 1, 2 y 3 son válidos para un
campo de tipo INT.
- Para los campos de caracteres, la entrada de usuario se compara con el rango de valores para el
número de caracteres para el que es posible una comparación. Por ejemplo, el rango ["a", "c"]
incluye (como válida) cualquier entrada cuyo primer carácter sea "a", "b" o "c". Aunque la serie
"cat" sea mayor que "c" en una secuencia de ordenación, "cat" es una entrada válida.
La regla
general es la siguiente: si el primer valor del rango se llama
lowValue y el segundo
highValue, la entrada del usuario es válida si se cumple
cualquiera de estas
condiciones:
- La entrada de usuario es igual a lowValue o highValue
- La entrada de usuario es mayor que lowValue y menor que highValue
- La serie inicial de caracteres de entrada coincide con la serie inicial de caracteres en
lowValue, mientras es posible una comparación
- La serie inicial de caracteres de entrada coincide con la serie inicial de caracteres en
highValue, mientras es posible una comparación
A continuación se proporcionan algunos ejemplos:
// los valores válidos son 1, 2, 3, 5, 7, 9 y 11
validValues = [[1, 3], 5, 7, 11]
// los valores válidos son las letras "a" y "z"
validValues = ["a", "z"]
// los valores válidos son las series que empiezan por "a"
validValues = [["a", "a"]]
// los valores válidos son cualquier serie
// que empiece por una letra minúscula
validValues = [["a", "z"]]
Si la entrada del usuario no está dentro del rango especificado, el entorno de
ejecución de EGL visualiza un mensaje, como se describe en relación con la propiedad de
campo validValuesMsgKey.