|
» Component » Label » Button » CheckBox » ComboBox » TextField » PasswordField » TextArea » TabbedPane » Panel » Desktop » Dialog » SpinBox » ProgressBar » Slider » SplitPane » List » Table » Tree » Separator » MenuBar
|
|
|
ComboBox
ComboBox is a combination of a text field and drop-down list.
This example has a default value, two choices, and it is editable.
<combobox text="ComboBox">
<choice text="Choice" icon="image.gif" />
<choice text="Disabled" enabled="false" />
</combobox> |
Parameters
Name | Type | Default | Description | icon | icon | null |
The icon image that the combobox displays.
|
action | method | null |
Invokes the given method when there was change in the text or a new
choice was selected.
|
selected | integer | -1 |
The index of the currently selected choice, value -1
indicates a custom edited value in an editable box.
|
text, columns, and editable parameters are described at textfield
|
name, enabled, visible, tooltip, width, height, colspan, rowspan,
weightx, weighty, halign, and valign parameters are similar to component
|
Choice
The drop down list of a combobox contains choices.
The popup combolist internally handles scrolling.
Parameters
Name | Type | Default | Description | name | string | null |
Identifies the item.
|
enabled | boolean | true |
Enables or disables the item. A disabled item is painted gray,
and can't be selected by mouse or keyboard.
|
text | string | null |
The text text that the choice displays.
|
icon | icon | null |
The icon image that the choice displays.
|
alignment | choice | left |
The alignment of the text and image similar to label.
Possible values are: left, center, and right.
|
tooltip | string | null |
The text pops up when the mouse lingers inside this specified part of the component,
otherwise the tooltip text of the component.
|
Keyboard-actions
Operation | Action | Spacebar, Down arrow | Post menu |
Up arrow | Selects previous (or last) choice |
Down arrow | Selects next (or first) choice |
Home | Selects first choice |
End | Selects last choice |
Page Up | Selects choice one view up |
Page Down | Selects choice one view down |
Enter, Return, Spacebar | Activates selection, and retract menu |
Escape | Retract menu without taking selection |
Tab, Shift-Tab | Navigate forward, backward |
|