Displays a multiselection text box, which displays as a two-part object in which a defined set of values in one box can be moved to a selected box. Values in the left box are defined by the allowedValues property, values are often obtained dynamically by calling a Java method such as FormUtil.getResources. The values displayed in the right side of a multiselection box are populated from the current value of the associated view attribute, which is identified through the field name.
The form titles for this two-part object are set through the availabletitle and selectedtitle properties.
If you want a MultiSelect component that does not use an applet, set the noApplet property to true.
See Alternative to the MultiSelect Component for a related discussion.
If you are running Waveset on a system running the Safari browser, you must customize all forms containing MultiSelect components to set the noApplet option. Set this option as follows:
<Display class=’MultiSelect’> <Property name=’noApplet’ value=’true’/> ...
Properties for this display component are:
allowedValues– Specifies the values associated with the left side of the multiselection box. This value must be a list of strings. Note: The <Constraints> element can be used to populate this box, but its use is deprecated.
availableTitle– Specifies the title of the available box.
class - Specifies the CSS class to use to style the MultiSelect buttons when the component is not rendered as an applet. Defaults to formbutton.
disabledclass - Specifies the CSS class to use to style the disabled MultiSelect buttons when the component not rendered as an applet. Defaults to formbutton.
displayCase– Maps each of the allowedValues to their uppercase or lowercase equivalents. Takes one of these two values: upper and lower.
height– Specifies the width of the selected box in pixels. The default value is 400.
noApplet– Specifies whether the MultiSelect component will be implemented with an applet or with a pair of standard HTML select boxes. The default is to use an applet, which is better able to handle long lists of values. See preceding note for information on using this option on systems running the Safari browser.
onBlur - Javascript to execute on an onFocus event for the multiselect buttons. You can use this property to change the style of the button when the button loses focus.
onFocus - Contains the Javascript to execute on an onFocus event for the MultiSelect buttons. This can be used to change the style of the button when the button is focused.
onMouseOver - Contains the Javascript to execute on an onMouseOver event for the MultiSelect buttons. You can use this property to change the style of the button when mousing over it.
onMouseOut - Contains the Javascript to execute on an onMouseOut event for the MultiSelect buttons. You can use this property to change the style of the button when moving the mouse off it.
ordered– Defines whether selected items can be moved up or down within the list of items in the text box. A true value indicates that additional buttons will be rendered to permit selected items to be moved up or down.
selectedTitle– Specifies the title of the selected box.
sorted– Specifies that the values in both boxes will be sorted alphabetically.
typeSelectThreshold– (Available only when the noApplet property is set to true.) Controls whether a type-ahead select box appears underthe allowedValue list. When the number of entries in the left selectbox reaches the threshold defined by this property, an additional text entry field appears under the select box. As you type characters into this text field, the select box will scroll to display the matching entry if one exists. For example, if you enter w, the select box scrolls to the first entry that begins with w.
width– Specifies the width of the selected box in pixels. The default value is 150.
<Field name=’accounts[LDAP].LDAPDept’ type=’string’> <Display class=’MultiSelect’ action=’true’> <Property name=’title’ value=’LDAP Department’/> </Display> <Constraints> <o> <List> <String>Sales</String> <String>Marketing</String> <String>International Sales</String> </List> </o> </Constraints> </Field>