>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  XLIST






      Pop-up list selection widget.


Calling Sequence

      out = xlist(list)


      list = string array of possible selections. in

Keyword Parameters


        TITLE=txt title text or text array (def=Select item).
        MAXSCROLL=n Max allowed lines before scrolling list used
        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.


      out = selected element. out
        Null if Cancel button pressed.

Common Blocks



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.

© 2022 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us