validValues
validValues プロパティー (以前の range プロパティー) は、ユーザーが入力できる有効な一連の値を示します。このプロパティーは、数値フィールドまたは文字フィールドに使用されます。
このプロパティーは、単一および 2 つの値の要素からなる配列リテラルを指定します。例を以下に示します。
validValues = [ [1,3], 5, 12 ]
validValues = [ "a", ["d", "i"]]
各単一要素には、1 つの有効な値が含まれ、2 つの値の各要素には範囲が含まれます。以下のガイドラインが適用されます。
- 数値の場合、左端の値が有効な最下位の値で、右端の値が有効な最上位の値です。最初の例では、値 1、2、3、5、および 12 が INT 型のフィールドに有効です。
- 文字フィールドでは、比較が可能な文字数である場合、ユーザー入力は値の範囲に照らして比較されます。
例えば、範囲 ["a", "c"] には、先頭文字が「a」、「b」、または「c」であるすべての入力データが (有効として) 含まれます。
照合シーケンスでは、ストリング「cat」は「c」より大きくなって
いますが、「cat」は有効な入力データです。
一般的な規則では、範囲内の最初の値は lowValue が指定され、2 番目の値は highValue が指定されます。 以下のいずれかのテストに合格した場合、ユーザーの入力データは有効です。
- ユーザー入力が、lowValue または highValue に等しい。
- ユーザー入力が lowValue より大きく、highValue より小さい。
- 比較が可能であるかぎり、最初の一連の入力文字は、lowValue 内の最初の一連の文字と一致する。
- 比較が可能であるかぎり、最初の一連の入力文字は、highValue 内の最初の一連の文字と一致する。
ユーザー入力が指定された範囲外の場合、EGL はエラー・メッセージを表示します。validValuesMsgKeyを参照してください。
例
以下に追加した例は、プロパティーの可能な範囲を示しています。
// 有効な値は、1、2、3、5、7、および 11
validValues = [[1, 3], 5, 7, 11]
// 有効な値は、文字「a」および「z」
validValues = ["a", "z"]
// 有効な値は、「a」で始まる任意のストリング
validValues = [["a", "a"]]
// valid values are any string
// beginning with a lowercase letter
validValues = [["a", "z"]]
//.ストリング "baa" は、ここでは無効になる
validValues = [ "a", ["bbb", "i"]]
//.ストリング "baa" は、ここで有効になる
validValues = [ "a", ["b", "i"]]
互換性
| データ項目 | VGUI レコード | コンソール UI | テキスト書式 Java™ | テキスト書式 COBOL | 印刷書式 Java | 印刷書式 COBOL |
|---|---|---|---|---|---|---|
| あり | あり | あり | あり | あり* | なし | なし |
* 以下の互換性に関する追加の考慮事項が該当します。
| プラットフォーム | 問題 |
|---|---|
| COBOL 生成 | テキスト書式でのみ、数値フィールドおよび一対の有効な値がサポートされます。 |