Class List
Object
|
+--Widget
|
+--Container
|
+--List
-
Direct Known Subclasses:
-
DropDownList
- class
List
- extends Container
Raises:
selectionchanged
- whenever the list's selection changed. Listeners are passed an
AbstractList
containing all the ListItem
s that are currently selected.
Defined in list.js
Constructor Summary |
List
(multiSelect, rowCount)
Creates a list widget.
|
Methods inherited from class Container |
appendChild, clear, contains, insertAfter, insertAt, insertBefore, isEmpty, prependChild, removeChild, replaceChild, setLayout, setEnabled
|
Methods inherited from class Widget |
installContextMenu, installDefaultContextMenu, uninstallContextMenu, isDraggable, setDraggable, addEventListener, blur, createEventTable, dispose, focus, getAbsoluteBottom, getAbsoluteLeft, getAbsoluteRight, getAbsoluteTop, getBottom, getBounds, getClientHeight, getClientWidth, getCorner, getHeight, getLeft, getPixelsPerEm, getRight, getToolTip, getTop, getWidth, isDisposed, isEnabled, layout, moveToAbsolute, moveTo, raiseEvent, registerEventType, removeEventListener, setAbsoluteBottom, setAbsoluteLeft, setAbsoluteRight, setAbsoluteTop, setBottom, setBounds, setHeight, setLeft, setRight, setToolTip, setTop, setWidth, setParent, toString
|
setEnabled
var setEnabled
List
function List(multiSelect, rowCount)
Creates a list widget. Lists can only sensibly contain instances of
ListItem
. Note that all the content-manipulation methods
except appendChild
are linear-time in Internet Explorer.
Parameters:
multiSelect
- (Optional) a boolean
indicating whether or not the list should allow multiple items to be selected at once. Defaults to false
.
rowCount
- (Optional) an int
indicating how many rows to display in the list. This parameter might be useless since lists will display as many items as can fit in their height. Defaults to 5
to garauntee that we get a list, and not a drop-down list.
getSelection
WidgetList getSelection()
Returns a list of ListItem
s that are selected.
Returns:
this list's selection as a WidgetList
getValue
function getValue()
setSelection
void setSelection(selection)
Selects the ListItems
in the given list, and deselects all others.
Parameters:
selection
- a list of list items to select
setSelectionByValue
void setSelectionByValue(selection)
Selects the ListItems
by their values as specified in
selection
.
Parameters:
selection
- An abstract_list
, array or string specifying the items to select.