Use of this API subroutine is now deprecated - it can still be used, but for new developments it is recommended that you use RW_SELECT_LIST for enhanced functionality.
Generates a pull-down menu of choices.
RW_LIST(Name, Style, Size, aValueText)
Name A name, unique within the form, for the list.
Style If set to the string, 'multiple', more than one item may be selected by a user; otherwise, only one option can be selected at a time.
Size Specifies the number of list items that are visible in the list's window. If the number of entries in the list exceeds Size, a vertical scroll bar will be presented on the list window. If Size is set to '0' or '1', the list window will sized for one item only, but when the down-arrow icon is selected a drop-down list containing the complete list will be displayed.
aValueText A dynamic array, with one attribute for each list item. Each attribute can contain up to three values:
- The first value is returned as the result of the selection.
- The second value, if present, specifies the text to be displayed in the list box for that item. This text defaults to being the same as the first value, if no second value is specified.
A non-NULL third value should only be present in one attribute - this marks the attribute as the default selection.
If Style is set to 'multiple', more than one entry can be enabled as a default.
Requires a previous call to RW_START_FORM.
The subroutine that processes the submitted form can retrieve the user's selection(s) by calling RW_GET_PARAM and specifying the name of the list as the parameter name.