Rich UI ListMulti
The Rich UI listMulti widget defines a list from which the user
can select multiple entries. The following properties are supported:
- values, which holds an array of strings that each represent a selectable option.
- selection, which holds an array of integer
that represent the position of the strings in the values array.
If you set the value of selection before
displaying the list box, the specified strings are displayed in boldface.
The first string in the array is at position 1, not 0.
- size, which holds an integer that indicates
how many strings to display from the values array.
The default is to display all the strings, with no scroll bar:
- If the value of size is smaller than
the number of strings, only the specified number of strings is displayed.
A scroll bar provides access to the other strings.
Initially, only the last strings are displayed.
- If the value of size is greater than the number of strings, additional spaces are added to the bottom of the list box. The user cannot select content from one of those spaces, which are only for display.
If you do not set the size property, Internet Explorer 6 displays the widget as a combo box (a combination text box and list box).
- If the value of size is smaller than
the number of strings, only the specified number of strings is displayed.
A scroll bar provides access to the other strings.
Other supported properties and functions are described in “Widget properties and functions.”
Use of this widget requires the following statement:
import com.ibm.egl.rui.widgets.ListMulti;