RWA_SELECT_LIST

Related Topics

Example

---

Purpose

Generates a pull-down menu of choices in a form. Appends the generated code to a string.

Syntax

RWA_SELECT_LIST(vString, Name, aValueText, aValue, aSelected, aClass)

Parameters

vString A variable containing the string to which the generated code is appended. On return, the variable contains the modified string. If the string does not exist, it is created.

Name A name, unique within the form, for the list.

aValueText A dynamic array A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  , with one attribute for each list item. Each attribute specifies the text to be displayed in the list box for that item.

aValue A dynamic array A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  , with one attribute for each list item. Each attribute specifies the  value to be returned when the form is submitted with that item selected.

aSelected A dynamic array A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  containing a Boolean A data type that can take only the values TRUE and FALSE. In RealWeb TRUE is defined as any non-zero integer, and FALSE as 0 or a null string. Any other values generate a run time error.  value for each list items. Items for which the element is TRUE will be preselected.

aClass A dynamic array A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  that can contain the following elements:

Element No.	Attribute	Description
1	CLASS	The name of a tag class defined in a CSS Cascading Style Sheet - a mechanism by which the presentation of an HTML page can be separated from the content. A style sheet can be used to determine the appearance of one or more HTML pages.  stylesheet.
2	STYLE	The style of the list. Enter MULTIPLE to enable multiple selections.
3	SIZE	The number of lines in the visible section of the select list.
4	OnClick	The name of the function to be run when the Onclick event occurs.

Attributes defined in the aClass parameter are applied to the SELECT tag.

For information about using aClass, see The aClass Parameter.

Dependencies

Requires a previous call to RW_START_HTML_FORM.