Syntax

Example

Description/Remarks

LIST_F "message", "file"

LIST_F "Pick a department", c:\gainseek\spc\data1\ trace1.txt

LIST_F "", c:\gainseek\spc\data1\ trace1.txt

This command prompts the user to select an item from a list. It then returns a value determined by the LIST_OPT command.

Valid options for the "file" parameter are:

• A valid path and file name.
  
  The contents of this file are used to fill the list that is displayed to the user.
  
  Each line in the file is considered a new item for the list, except for empty lines which are ignored.
  
  Note: A line containing a space is not considered blank and thus will be displayed in the list.

• A path and file name containing a search character (* or ?).
  
  The file names that match the search criteria are used to fill the list that is displayed to the user. Files are listed in alphabetical order.
  
  If no files match the search criteria, a message will be displayed instead of the list.

The "message" parameter determines the text that will be displayed above the list. To use the default message ("Please pick an item from the list"), use an empty string ("") for this parameter.

You can use LIST_OPT to modify display settings for this list.