<sas:ListBox>

Generates the appropriate HTML 4.0/XHTML 1.0 INPUT tag attributes to represent a listbox.

Syntax

<sas:ListBox
   [accessKey="java.lang.String"]
   [customAttributes="java.lang.String"]
   [descriptionModel="java.lang.String"]
   [enabled="false|true"]
   [epilog="java.lang.String"]
   [id="value"]
   [instantiate="true|false"]
   [locale="java.util.Locale"]
   [model="java.lang.String"]
   [multipleSelections="true|false"]
   [name="java.lang.String"]
   [objectDataProperty="java.lang.String"]
   [onBlur="java.lang.String"]
   [onChange="java.lang.String"]
   [onClick="java.lang.String"]
   [onDblClick="java.lang.String"]
   [onFocus="java.lang.String"]
   [onKeyDown="java.lang.String"]
   [onKeyPress="java.lang.String"]
   [onKeyUp="java.lang.String"]
   [onMouseDown="java.lang.String"]
   [onMouseMove="java.lang.String"]
   [onMouseOut="java.lang.String"]
   [onMouseOver="java.lang.String"]
   [onMouseUp="java.lang.String"]
   [onSelect="java.lang.String"]
   [prolog="java.lang.String"]
   [ref="java.lang.String"]
   [render="true|false"]
   [renderType="html|wml|hdml"]
   [scope="page|request|session|application"]
   [selectedIndexes="java.lang.String"]
   [selectedItems="java.lang.String"]
   [selectedItemsModel="java.lang.String"]
   [size="int"]
   [styleClassPrefix="java.lang.String"]
   [tabIndex="java.lang.String"]>
      [<sas:Item .../>]
      [<sas:StyleInfo .../>]
      [<sas:RequiredStringValidator .../>]
      [<sas:SetProperty ...>
         The value to set on the parent tag
      </sas:SetProperty>]
      [Additional <sas:Item>, <sas:SetProperty> tags...]
      [One or more data items on separate lines]
</sas:ListBox>

Attributes

accessKey	The shortcut to apply to the Form control.
customAttributes	a list of attributes in the form of attribute="value", space delimited
descriptionModel	Alternate display name for items in the model at run-time.
enabled	The state of the ListBox element; "false" results in a disabled listbox.
epilog	Text that is output immediately after the last markup tag.
id	Case-sensitive name used to identify the object instance.
instantiate	Flag that, if true, indicates that a new instance of the underlying class should be loaded if one cannot be found in PageContext. Must be used with an id attribute.
locale	Specifies the locale to use for this instance of the class.
model	The model of the ListBox.
multipleSelections	Specifies whether or not multiple items can be selected in the ListBox.
name	Value assigned to the markup tag's name attribute.
objectDataProperty	Value assigned to the output tag's objectDataProperty attribute.
onBlur	The onBlur event handler to apply to the Form control.
onChange	The onChange event handler to apply to the Form control.
onClick	The onClick
onDblClick	The onDblClick
onFocus	The onFocus event handler to apply to the Form control.
onKeyDown	The onKeyDown
onKeyPress	The onKeyPress
onKeyUp	The onKeyUp
onMouseDown	The onMouseDown
onMouseMove	The onMouseMove value
onMouseOut	The onMouseOut event handler to apply to the Form control.
onMouseOver	The onMouseOver event handler to apply to the Form control.
onMouseUp	The onMouseUp
onSelect	The onSelect
prolog	Text that is output immediately preceeding the first markup tag.
ref	The variable String value that represents an object created earlier in the same scope.
render	Flag that, if true, indicates that the complete markup of the bean is output when the tag is closed. It also sets the the visible property on the underlying TransformationBean.
renderType	Type of markup for the output tag(s).
scope	The scope (or page context) within which the reference is available.
selectedIndexes	A space-delimitted string of index numbers for selected items in the ListBox.
selectedItems	A comma-delimitted string of selected items specified in the ListBox.
selectedItemsModel	The model of selected items specified in the ListBox.
size	The viewable size of the ListBox at one time.
styleClassPrefix	The styleClassPrefix
tabIndex	The tabindex to apply to the Form control.

More Information

To view the documentation for the related TransformationBean, see com.sas.servlet.tbeans.form.BaseListBox.

If you need to subclass the tag handler class for the sas:ListBox tag, extend com.sas.taglib.servlet.tbeans.form.ListBoxTag.