| Navigation: Language Reference > 13 - Built-in Functions >====== CHOICE (return relative item position) ====== |    |
CHOICE( [control] )
| CHOICE | Returns a user selection number. |
| control | A field equate label of a LIST, COMBO, SHEET, or OPTION control. |
The CHOICE procedure returns the sequence number of a selected item in an OPTION structure, SHEET structure, LIST box, or COMBO control. With no parameter, CHOICE returns the sequence number of the selected item in the last control (LIST, SHEET, OPTION, or COMBO) that generated a Field-specific event to cycle the ACCEPT loop. CHOICE(control) returns the current selection number of any LIST, SHEET, OPTION, or COMBO in the currently active window.
CHOICE returns the sequence number of the selected RADIO control within an OPTION structure. The sequence number is determined by relative position within the OPTION. The first control listed in the OPTION structure's code is relative position 1, the second is 2, etc.
CHOICE returns the memory QUEUE entry number of the selected item when a LIST or COMBO box is completed.
| Return Data Type: | SIGNED |
Example:
CODE
ACCEPT
EXECUTE CHOICE() !Perform menu option
AddRec !procedure to add record
PutRec !procedure to change record
DelRec !procedure to delete record
RETURN !return to caller
END
END
See Also: