|
A list with an optional leading label. The user selection (the selected indices) is saved to a variable.
|
Properties: |
-
Fill horizontal space
If set, the list will fill all the available horizontal space, otherwise it will be as wide as required for the the widest item.
-
Fill extra vertical space
If set, the component will expand to fill remaining vertical space. Extra vertical space is only available, if the form is not scrollable. Custom form screens have a "Scrollable" property, which must be set to false.
-
Icon-text gap
The gap between the label icon and the label text in pixels.
-
Initially selected index
The zero-based index of the initially selected item in the list.
-
Font color
The color of the label font. If empty, the default color will be used.
-
Font
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Icon
An image file with an icon for the label. Can be empty.
-
Text
The text of the label. Can be empty.
-
List entries
The items in the list as a list separated by semicolons. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. Items that are installer variables with array values (e.g. String[] or Object[]) are expanded as separate items, this allows you to build a variable length list of items at runtime.
-
Multi-selection
If set, the user can select multiple entries at the same time.
-
Scrollable
If set, the list will be wrapped in a scroll pane.
-
Selection change script
A script that is executed when the selection is changed by the user. This script is only required for advanced customizations of the form screen. The return type is void.
-
Variable name
The name of the variable to which the user input is assigned. If multiple items can be selected, the variable value will be an int array with the selected indices, otherwise the variable value will be the index of the selected item as a java.lang.Integer
-
Visible rows
If the list is scrollable, this property determines the height of the list.
|
|