validValues

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.

Conceptos relacionados
Formularios de texto

Consulta relacionada
Propiedades de validación
validationFailed()
Componente DataTable en formato fuente EGL
verifyChkDigitMod10()
verifyChkDigitMod11()

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.