XLIST Name
XLIST Purpose
Pop-up list selection widget. Category
Calling Sequence
out = xlist(list) Inputs
list = string array of possible selections. in
Keyword Parameters
Keywords
TITLE=txt title text or text array (def=Select item).
MAXSCROLL=n Max allowed lines before scrolling list used
(def=20).
HIGHLIGHT=i Line to highlight (def=none).
TOP=j Line to make be the top of the list.
INDEX=indx Returned index of selected item.
/MULTIPLE Allow multiple selections.
/SEARCH Add a search entry area.
ITXT=itxt Initial search text (def=none).
SMODE=mode Initial search mode:
1=Starts with (def), 2=Contains.
OUT=out Returned structure with final search mode
and search text: out={smode:smode,stxt:stxt}.
/WAIT means wait for a selection before returning.
Needed if called from another widget routine.
Outputs
out = selected element. out
Null if Cancel button pressed.
Common Blocks
xlist_init_com Notes
Modification History
R. Sterner, 11 Nov, 1993
R. Sterner, 2003 Dec 11 --- Added /MULTIPLE.
R. Sterner, 2004 Jun 24 --- Fixed OK with no selection.
Robert Mallozzi's dialog_list had some key clues.
R. Sterner, 2004 Aug 02 --- Added /SEARCH.
R. Sterner, 2004 Aug 30 --- Added search options: Starts with/Contains.
R. Sterner, 2004 Aug 31 --- Added list size label.
R. Sterner, 2004 Sep 27 --- Fixed a typo in list setup.
R. Sterner, 2007 Dec 18 --- Error stop message if result not a struct.
R. Sterner, 2007 Dec 18 --- Return index = -1 for cancel.
Copyright (C) 1993, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.