validValues

validValues 특성(이전 버전의 range 특성)은 사용자 입력에 유효한 값 세트를 표시합니다. 이 특성은 숫자 또는 문자 필드에 사용됩니다.

이 특성은 다음 예에서와 같이 단일 및 두 개 값 요소의 배열 리터럴을 지정합니다.
  validValues = [ [1,3], 5, 12 ]
  validValues = [ "a", ["d", "i"]] 
각 단일 요소에는 유효한 값이 포함됩니다. 각 두 개 값 요소에는 범위가 포함됩니다. 다음 가이드라인이 적용됩니다.
  • 숫자의 경우 맨 왼쪽 값은 유효한 최하위 값이고, 맨 오른쪽 값은 최상위 값입니다. 첫 번째 예에서 값 1, 2, 3, 5, 12는 INT 필드에 유효합니다.
  • 문자 필드의 경우 사용자 입력은 비교가 가능한 문자 수의 값 범위와 비교할 수 있습니다. 예를 들어, ["a", "c"] 범위에는 첫 번째 문자가 "a", "b" 또는 "c"인 (유효한) 입력이 포함되어 있습니다. "cat" 문자열이 조합 순서에서 "c"보다 크더라도 "cat"이 유효한 입력입니다.
    일반적으로 범위의 처음 값이 lowValue로 지정되고 두 번째 값이 highValue로 지정된 경우 다음 테스트를 통과하면 사용자 입력이 유효하게 됩니다.
    • 사용자 입력은 lowValue 또는 highValue와 같습니다.
    • 사용자 입력은 lowValue보다 크고 highValue보다 작습니다.
    • 일련의 초기 입력 문자는 (비교가 가능한 경우) lowValue에 있는 일련의 초기 문자와 일치합니다.
    • 일련의 초기 입력 문자는 (비교가 가능한 경우) highValue에 있는 일련의 초기 문자와 일치합니다.

사용자 입력이 특정한 범위 밖에 있으면 EGL에서 오류 메시지를 표시합니다. validValuesMsgKey의 내용을 참조하십시오.

다음 추가 예에서는 특성에 가능한 범위를 표시합니다.
  // valid values are 1, 2, 3, 5, 7, and 11
  validValues = [[1, 3], 5, 7, 11]

  // valid values are the letters "a" and "z"
  validValues = ["a", "z"]

  // valid values are any string beginning with "a"
  validValues = [["a", "a"]]

  // valid values are any string 
  // beginning with a lowercase letter
  validValues = [["a", "z"]]

  //.The string "baa" is NOT valid here
validValues = [ "a", ["bbb", "i"]]

  //.The string "baa" IS valid here
  validValues = [ "a", ["b", "i"]]

호환성

표 1. validValues 특성에 대한 지원
데이터 항목 VGUI 레코드 콘솔 UI 텍스트 양식 Java™ 텍스트 양식 COBOL 인쇄 양식 Java 인쇄 양식 COBOL
예* 아니오 아니오

* 다음 추가 호환성 고려사항이 적용됩니다.

표 2. validValues에 대한 호환성 고려사항
플랫폼 문제
COBOL 생성 텍스트 양식은 숫자 필드와 올바른 값의 단일 쌍만을 지원합니다.