CHOICE (return relative item position)

Top  Previous  Next

 

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:

LIST

SHEET

COMBO

OPTION

QUEUE

RADIO

PROP:Selected

PROP:ChoiceFEQ