This command is undocumented in the original VFP9 help file,
but the following documentation was found in the FoxPro for Windows 2.6 help, and may still be valid:

Creates a list.

Parameters

row, column
 Row and column are numeric expressions with values of 0 or greater that determine where the list appears.

 The first row is number 0 in the main FoxPro window or a user-defined window. Rows are numbered from top to bottom. In FoxPro for Windows, row 0 is the row immediately under the FoxPro system menu bar. In FoxPro for Macintosh, row 0 is the row immediately under the FoxPro title bar. In FoxPro for MS-DOS, row 0 is the row the FoxPro system menu bar occupies. See SET SYSMENU for information about manipulating the system menu bar so you can place output on row 0 in FoxPro for MS-DOS.

 The first column is number 0 in the main FoxPro window or a user-defined window. Columns are numbered from left to right.

 When the list is directed to a user-defined window, the row and column coordinates are relative to the user-defined window, not the main FoxPro window.

 In FoxPro for Windows and FoxPro for Macintosh, a position in the main FoxPro window or in a user-defined window is determined by the font of the main FoxPro window or the user-defined window. Most fonts can be displayed in a wide variety of sizes, and some are proportionally spaced. A row corresponds to the height of the current font; a column corresponds to the average width of a letter in the current font.

 In FoxPro for Windows and FoxPro for Macintosh, you can position the list in a window with decimal fractions for row and column coordinates. In FoxPro for MS-DOS, decimal fractions used for row and column coordinates are rounded to the nearest integer value.

memvar | field
 When you choose an item from a list, a value corresponding to your choice is stored to the memory variable or array element memvar, or the field field. memvar or field must be of numeric or character type. If memvar or field is numeric, the chosen item's position in the list is stored. If memvar or field is character, the chosen item's prompt is stored.

Initial Option Selection
 When a list appears, the value of memvar or field determines which list option (if any) is initially selected. For example, if the value of memvar or field is 4, the fourth option in the list is selected when the list is activated by READ. If memvar or field doesn't correspond to any of the options in the list (the value is less than 1 or greater than the number of options), no option is initially selected.

FROM array
 The FROM array clause creates a list from an array. If the array is one-dimensional, the contents of the first array element are the first item in the list, the contents of the second array element are the second item and so on.

 If the array is two-dimensional, the elements in the first column of the array are used to create the list items. The first element in the first column is the first item in the list, the second element in the first column is the second item, and so on.

RANGE expN1 [, expN2]
 List items by default starting with the contents of the first array element. You can designate a different starting element in the array by including RANGE expN1. For example, if the array is one-dimensional and expN1 is 3, the third element in the array is the first item in the list, the fourth element is the second item, and so on.

 An element's position number in a two-dimensional array is determined by counting along rows. For example, suppose you create the following 3-by-3 array:

 a b c

 d e f

 g h i

 Elements a, b, and c are in position numbers 1, 2, and 3. Elements d, e, and f are in position numbers 4, 5, and 6, and so on. If a two-dimensional array is used, only elements in the same column as array element expN1 become items in the list. For example, if expN1 is 2, the contents of elements b, e, and h are the list items. If expN1 is 5, only the contents of elements e and h are included.

 If you include a starting element expN1, you can also specify the number of elements in the list by including expN2. If expN2 isn't included, the contents of all array elements from the starting element expN1 through the last element in the column are items in the list.

 If SHOW GETS is issued, the RANGE clause is reevaluated. If the value of expN1 or expN2 has changed, the list is updated to reflect the changes.

 The contents of a list can be dynamically changed. You can insert and remove items by modifying the array. The ACOPY(), ADEL(), ADIR(), AELEMENT(), AFIELDS(), AINS(), ALEN(), ASCAN(), ASORT() and ASUBSCRIPT() functions facilitate the manipulation of arrays.

POPUP pop-up name
 The list can also be built from a popup created with DEFINE POPUP. Each popup item is used to create an item in the list.

 To create a list from a popup, first create the popup with DEFINE POPUP. Include in the POPUP popup name clause the name of the popup created with DEFINE POPUP.

 You can create a popup (and thus, a list) containing records from a field in a table (PROMPT FIELDS), files available on disk (PROMPT FILES) or the names of the fields in a table (PROMPT STRUCTURE).

 The following example demonstrates how to create a list from a popup. DEFINE POPUP is used to create a popup containing the names of table files available on disk. The table names appear as options in the list. MARGIN is included to provide an additional space for the mark character. The SCROLL option places a scroll bar to the right of the list.

 CLEAR
 SET TALK OFF
 STORE 1 TO mchoice

 DEFINE POPUP scrollopts FROM 0, 0 PROMPT FILES LIKE *.DBF ;
  MARGIN SCROLL

 @ 2,2 GET mchoice POPUP scrollopts SIZE 8, 20

 READ && Activate the list.

FUNCTION expC1 | PICTURE expC2
 To terminate the READ when an item is chosen from the list, include FUNCTION '&T' or PICTURE '@&T'. Include FUNCTION '&N' or PICTURE '@&N' to prevent the READ from terminating when an item is chosen from the list. For example:

 ... FUNCTION '&T' ...
 ... PICTURE '@&T' ...

 If a FUNCTION or PICTURE clause isn't included, the READ isn't terminated when an item is chosen.

 In FoxPro for Macintosh, you can create a two- or three-dimensional list by including 2 or 3 after the & specification code. Include 2 to create a flat, two-dimensional list identical to lists in Macintosh dialogs. Include 3 to create a three-dimensional list identical to lists in FoxPro for Macintosh dialogs. A two-dimensional list is created by default if you omit the 2 and 3 specification codes.

 In FoxPro for Macintosh, the following clause creates a three-dimensional list and doesn't cause the READ to terminate when an item is chosen from the list.

 ... FUNCTION '&N3' ...

FONT expC3 [, expN3]
 The character expression expC3 is the name of the font, and the numeric expression expN3 is the font size. For example, the following clause can be used to display the items in the list in 16-point Courier font:

 FONT 'Courier', 16

 If you include the FONT clause but omit the font size expN3, a 10-point font is used.

 In FoxPro for Windows, if the font you specify is not available, a font with similar font characteristics is substituted.

 In FoxPro for Macintosh, if the font you specify is not available, the Chicago font is used.

 In FoxPro for MS-DOS, the FONT clause is ignored.

 If the FONT clause is omitted and the list is placed in the main FoxPro window, the main FoxPro window font is used. If the FONT clause is omitted and the list is placed in a user-defined window, the user-defined window font is used.

STYLE expC4
 In FoxPro for Windows and FoxPro for Macintosh, include the STYLE clause to specify a font style for the items in the list.

 The font style is specified with expC4. If the STYLE clause is omitted, the normal font style is used.

 In FoxPro for Windows, if the font style you specify is not available, a font style with similar characteristics is substituted.

 In FoxPro for Macintosh, if the font you specify is not available, the normal font style is used.

 The STYLE clause is ignored in FoxPro for MS-DOS.

 Character Font Style
 --------- ----------
 
  B  Bold

  C  Condense*

  E  Extend*

  I  Italic

  N  Normal

  O  Outline

  Q  Opaque

  S  Shadow

  -  Strikeout*

  T  Transparent

  U  Underline

 * The Condense and Extend styles are only available in FoxPro for Macintosh. The Strikeout style is only available in FoxPro for Windows.

 You can include more than one character to specify a combination of font styles. For example, the following clause specifies Bold Italic:

 STYLE 'BI'

DEFAULT expr
 When you choose an item from the list, your choice is saved in a memory variable, array element or field you specified. If you specify a memory variable that doesn't exist, it is automatically created and initialized if you include the DEFAULT clause. However, an array element isn't created if you specify an array element in a DEFAULT clause. The DEFAULT clause is ignored if the memory variable already exists or you specify a field.

 -------------------------------
 Note - If the DEFAULT clause is omitted and the memory variable memvar doesn't exist, the error message "Variable not found" appears.
 -------------------------------
 
 The DEFAULT expression expr determines the type of memory variable created and its initial value. expr must be of numeric or character type.

SIZE expN4, expN5
 The width of the list is, by default, determined by the width of the longest item text in the list. The number of items in the pop-up or array by default determines the number of items displayed in the list. You can optionally specify the length and width of the list by including SIZE. The length of the list in rows is specified by expN4, and the width of the list in columns is specified by expN5.

 If there are more items than can be displayed in the list at one time, a scroll bar is automatically placed to the right of the list items.

 In FoxPro for Windows and FoxPro for Macintosh, the list's font determines the size of the editing region. The list's font is specified with the FONT clause. If the FONT clause is omitted, the list uses the font of its parent window (the main FoxPro window or a user-defined window).

ENABLE | DISABLE
 Lists are by default enabled when READ is issued. You can prevent a list from being activated when READ is issued by including DISABLE. A disabled list cannot be selected and appears in disabled colors. Use SHOW GET ENABLE to enable a disabled list.

MESSAGE expC5
 The MESSAGE clause character expression expC5 appears when a list is selected. In FoxPro for MS-DOS, the message is centered on the last line of the main FoxPro window and the message location can be changed with SET MESSAGE.

 In FoxPro for Windows and FoxPro for Macintosh, the message is placed in the graphics-based status bar. If the graphics-based status bar has been turned off with SET STATUS BAR OFF, the message is placed on the last line of the main FoxPro window.

VALID expL1 | expN6
 You can include an optional VALID expression expL1 or expN6 that is evaluated when an option is chosen from the list. That is, VALID isn't evaluated when you select an item, but when you actually choose an item by selecting it and pressing Enter or double-clicking on the item.

 Typically, expL1 or expN6 is a user-defined function (UDF). With a user-defined function you can select, enable or disable other @ ... GET input fields or objects, open a Browse window, open another data-entry screen or move to a new record. CLEAR READ can be included in the user-defined function to terminate the READ.

expL1
 When a logical value is returned to the VALID clause, the logical value is ignored and the list remains the current control. However, you can specify a UDF that returns a logical value to the VALID clause and then activates another object.

expN6
 A VALID clause that includes a numeric expression is used to specify which object is activated after an item in the list is chosen. Objects are @ ... GET input fields, check boxes, lists, popups, spinners, text-editing regions and each individual button in a set of push, radio and invisible buttons.

 The numeric expression expN6 has one of these effects:

  When expN6 = 0, the list remains the active control.

  When expN6 is positive, expN6 indicates the number of objects to advance. For example, when the list is selected and VALID returns 1, the next object is activated. If expN6 is greater than the number of objects remaining, the READ is terminated (unless READ CYCLE is issued to activate the objects).

  When expN6 is negative, expN6 specifies the number of objects to move back. For example, when you're positioned on a list and VALID returns -1, the previous object is activated. If expN6 moves back past the first object, the READ is terminated (unless READ CYCLE is issued to activate the objects).

WHEN expL2
 The WHEN clause allows or prohibits selection of a list based on the logical value of expL2, which must evaluate to a logical true (.T.) before any of the list can be selected. If expL2 evaluates to a logical false (.F.), the list cannot be selected and is skipped over if placed between other objects.

COLOR SCHEME expN7 | COLOR color pair list
 If you do not include a COLOR clause, the list's colors are determined by the color scheme for the main FoxPro window; if a list is placed in a user-defined window, the window's color scheme determines the list's colors.

 The colors of a list can be specified by including the number of an existing color scheme in the COLOR SCHEME clause or a set of color pairs in the COLOR clause.

 A color scheme is a set of 10 predefined color pairs. The color pairs in a color scheme can be changed with SET COLOR OF SCHEME. In FoxPro for MS-DOS the color pairs in a color scheme can also be changed in the Color Picker.

 A color pair is a set of two letters separated by a forward slash. The first letter specifies the foreground color and the second letter specifies the background color.

 For example, this color pair specifies a red foreground on a white background:

 R/W

 For a list of colors and their corresponding color letters, see SET COLOR Overview or Color Table by Color Pair.

 A color pair can also be specified with a set of six RGB (Red Green Blue) color values separated by commas. The first three color values specify the foreground color and the second three color values specify the background color. The color values can range from 0 through 255.

 The R/W color pair in the example above can also be specified with this RGB color pair:

 RGB(255,0,0,255,255,255)

 Color Pair   List
  Number  Attribute
 ----------  ---------

  1   Disabled option

  2   Enabled option

  3   Border and scroll bar*

  5   Message

  6   Selected list item

  9   Enabled list

  10   Disabled list

 * Controls drawn in background color.
 Bar drawn in dim of foreground color.

 This example uses the array created in the previous example to override the color scheme of the main FoxPro window with another predefined color scheme:

 ACTIVATE SCREEN
 CLEAR
 SET TALK OFF
 STORE 1 TO mchoice

 DEFINE POPUP scrollopts FROM 0,0 PROMPT FILES LIKE *.DBF ;
  MARGIN SCROLL COLOR SCHEME 4

 @ 2,2 GET mchoice POPUP scrollopts SIZE 8, 20
 READ && Activate the list

 The following example, which uses the array created in an example above, defines a list with the following color characteristics:

  A selected list item is shown in bright white on a blue background (W+/B).

  An enabled list is shown with yellow options on a blue background (GR+/B).

  A disabled list is shown with white options on a blue background (W/B).

 When you skip a color pair, you must include a comma where the color pair would have been.

 Here are the commands:

 CLEAR
 SET TALK OFF
 STORE 1 TO mchoice

 DEFINE POPUP scrollopts FROM 0,0 PROMPT FILES LIKE *.DBF ;
  MARGIN SCROLL COLOR ,GR+/B,,,,W+/B,,,,W/B

 @ 2,2 GET mchoice POPUP scrollopts SIZE 8, 20
 READ && Activate the list

Remarks

Example

See Also