MultiSelect
A MultiSelect widget is a list control that allows a user to select one or more items from a list of items. All items are presented with their descriptions in a vertical list contained in a scrollable window. The list of items is populated using the List object which is gotten from the ListCommand component that the MultiSelect control is wired to.
This component binds to a List data object that holds the keys of selected items.
Listing 1: MultiSelect UPL
!ui-multiselect:frmWorkDays
caption:$s{Work Days} binding:workDayList
style:$s{height:180px;}
list:$s{dayinweeklist}
| Name | Required | Type | Description |
|---|---|---|---|
| list | true | String | Name of the ListCommand that backs the list items. |
| listParams | false | String | A list of names of parameters to be passed to the execute() method of the ListCommand that backs the list items. The actual values passed to the execute() method are gotten from the bean properties or any of the container scopes. |
| listParamType | false | String | Indicates how the listParams attribute is treated. Value can be set to any string in the set: {IMMEDIATE,CONTROL,PANEL}. IMMEDIATE means listParams values are used directly as the list parameters. CONTROL means the list parameters are resolved within the CheckList instance value scope. PANEL mean the list parameters are resolved within the CheckList parent panel value scope. This attribute defaults to CONTROL. |
| listKey | false | String | The property of list item objects to use as keys in the list. A key represents the value of a selected item. This attribute defaults to 'listKey'. |
| listDescription | false | String | The property of list item objects to use as description. Descriptions are the actual labels displayed for each item. This attribute defaults to 'listDescription'. |