idlastro / Miscellaneous (Non-Astronomy) Procedures: SELECT_W

[Source code]

NAME
SELECT_W    
PURPOSE
Create a non-exclusive widget menu of items
EXPLANATION
More than one item may be selected or 'de-selected'.   
CALLING SEQUENCE
SELECT_W, items ,iselected, [ comments, command_line, only_one, 
                     SELECTIN = , COLUMNS=, Y_SCROLL_SIZE= ]
INPUTS
items - string array giving list of items that can be selected.
OPTIONAL INPUTS
comments - string array of comments (same number of elements as items)
       for each item in array selections.     Will be displayed as a
       tooltip when passing the cursor over the button for that item. 
       Should have the same number of elements as items; otherwise
       will be ignored (and no tooltips will be displayed).
command_line - optional command line to be placed at the bottom
        of the screen.  It is usually used to specify what the
        user is selecting.
only_one - integer flag. If set to 1 then the user can only select
        one item.  The routine returns immediately after the first
        selection is made.
columns - number of columns (default = 8)
_scroll_size - size of GUI in device coordinates for scrolling large lists.
OPTIONAL KEYWORD INPUT
SELECTIN - vector of items to be pre-selected upon input (not used for
        only_one option)
OUTPUT
iselected - list of indices in selections giving the selected
        items, in the order they were selected.
OPTIONAL OUTPUT KEYWORD
COUNT  - Integer scalar giving the number of items selected 
MODIFICATION HISTORY
Written, K. Venkatakrishna & W. Landsman, Hughes/STX    January, 1992
Widgets made MODAL.  M. Greason, Hughes STX, 15 July 1992.
hanged handling of MODAL keyword for V5.0   W.Thompson  September 1997
dded selectin keyword  D. Lindler 01/12/99 
dded Columns, y_scroll_size keyword inputs, D. Lindler 6/20/2013
se CW_BGROUP instead of obsolete XMENU, implement comments parameter
 as tooltips.   W. Landsman Aug 2013
estore SELECTIN capability  W. Landsman Aug 2013
luge for Unix systems when Y_SCROLL_SIZE set Nov 2013