Selection boxes in an INPUT statement are available on
mainframe computers only. For other platforms, selection boxes may be defined
in the map editor only.
Selection boxes can be attached to input fields. They are a comfortable alternative to help routines attached to fields, since you can code a selection box direct in your program. You do not need an extra program as with help routines.
You may define a selection box clause for every INPUT
variable of type alpha, regardless if this field is an input or output field,
or both.
The syntax is:
| SB=operand1 [,operand1]... |
where operand1 represents a value
operand which is used to fill up the selection box with items.
| Operand | Possible Structure | Possible Formats | Referencing Permitted | Dynamic Definition | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operand1 | C | S | A | A | yes | no | |||||||||||||||
With SB, you specify the values to be displayed within the selection box.
To assign a selection box to a field, specify the attribute
SB for an alpha INPUT field in your Natural program
using the following example syntax:
INPUT #FLD (SB='value1', #ITEM1, #ITEM2(1:3), #ITEM3(*))
The following topics are covered below:
It is possible to assign both a selection box and a help routine to a field.
Selection boxes can be defined for every variable field in an
INPUT statement.
Exceptions are the following:
| System Variables | For example: *PROGRAM,
*COM |
| Named Constants (mainframe only) | defined with a CONST clause of
DEFINE DATA
statement.
|
In addition to the SB attribute, other attributes
can be defined as well, for example: AD or
CD.
The selection box field does not have to be modifiable, as is the case
with AD=A
or AD=M.
In other words, it is possible to provide a selection box (and select values)
even for a write-protected output field, such as
AD=O.
If you use AD=O, the user is forced to choose from a set of
predefined values, which themselves appear in a selection box.
When a program containing a selection box is executed, the selection box is positioned on the screen according to the same positioning algorithm used for help windows; that is, the size and position of the selection box are determined automatically, "near" the field.
The color and intensified attributes assigned to the field are also applied to the values displayed in the corresponding selection box.
If an edit mask has been defined for the field, the edit mask is applied to all selection box values.
Using the INPUT
statement, you can define an edit mask for a field. This is demonstrated in
following code example.
DEFINE DATA LOCAL 1 A(A4) END-DEFINE MOVE 'ABCD' TO A * SET KEY PF1 = HELP FORMAT KD=ON * INPUT A (AD=M EM=X.X.X.X SB='1234','WXYZ') WRITE A END
The line size of the selection box matches the field length to which the box corresponds.
If a value intended for the selection box exceeds the line size of the selection box, the value is truncated.
Selection box values are displayed in the order they appear in the
SB attribute.
