|
List
A list allows the user to select one or more objects from a list,
and internally handles scrolling.
The following example list has three items, the first is selected and the
last is disabled, allows to select multiple items. <list selection="multiple">
<item text="List" selected="true" />
<item text="Item"/>
<item text="Disabled" enabled="false" />
</list>
Properties
| selection | choice | single | Possible values are: single, interval, and multiple. The default
single value allows to select one list item at a time, the interval
value to select one contiguous range of items, and the multiple
value to select one or more contiguous ranges of items. |
| line | boolean | true | If present and set to false, don't draw lines separating the list items. |
| name, enabled, visible, tooltip, property, width, height, colspan, rowspan,
weightx, weighty, halign, and valign parameters are similar to
component |
Listeners
| action | Calls the method whenever the selection changes. |
| perform | Calls the method whenever a double-click event occurs. |
Item
List contains items, items display a short text string and an image
and can be selected.
Properties
| selected | boolean | false | True if the item currently selected. |
| name, enabled, text, icon, alignment, tooltip, and property parameters
are similar to
combobox choice |
Keyboard-actions
| Up arrow | Selects previous item |
| Down arrow | Selects next item |
| Home | Selects first item |
| End | Selects last item |
| Page Up | Selects item one view up |
| Page Down | Selects item one view down |
| +Shift | Extends selection |
| +Ctrl | Set lead item |
| Space | Selects lead item |
| Ctrl-A, Ctrl-Slash | Selects all |
| Ctrl-Backslash | Deselects all |
| Tab, Shift-Tab | Navigate forward, backward |
|