List of Valid Inputs

If the field is not a date, and the type { is not specified, then setdef is interpreted as a list of possible complete entries. When specified, the choices will display on the bottom line of the terminal (as many as will fit) to assist the operator (unless disabled with the s code). A null string disables the feature (accepts all inputs)

The format of the string is:

/x1/x2/x3/x4/..../xn//)

Where:

/ Represents the element delimiter. It may be any non-numeric character except the minus sign. We suggest slash or comma. Note that the delimiter character must appear once in the first position, once between each element in the list (all blanks are significant), and twice at the end of the list

xn - The elements x1, x2, etc., represent the allowable inputs. They may be any length (up to the length of the field) and may differ in length. All characters are significant, as is upper/lower case.

The list elements may contain any of the following wildcards:

Wildcard

Result

*

Matches anything. Used only at the end of an element.

?

Matches any one character.

#

Matches any numeric digit.

@

Matches any alphabetic digit.

 

A-Shell (Only): In GUI mode (see GUI-related Codes code |G), a field with this type of setdef list will be converted to a drop-down combo box. The user can select an item from the list using the mouse, or type freely as before (provided the results match one of the entries in the list). Note that in this mode, the length of the items in the list may be longer than xmax, in which case the entry only has to match the first xmax characters of an item in the list (and only the first xmax characters are returned to the calling program). An example of a situation where this would be useful is a list of states, where you are only interested in the 2 character code, but to be helpful to the operator, the dropdown list could also contain the full name of each state (e.g. "CA California, WV West Virginia," etc.)

See Also

•   type ||C for forcing the field to be displayed as a combo box even when inactive. Without ||C, after exiting from the combo box editing mode, the field will be redisplayed as a normal sunken, static text field.

•   ||S and ||s for variations on the combo box matching logic.

•   cmdflg INFCF_DROPDOWN flag to force drop-down to open automatically

•   Auto-Complete