ListBox Control attributes
A ListBox control contains a series of predefined text values. Each ListBox control is linked to an symbolic variable. When the selection in the control changes, the variable's value is updated accordingly. The variable itself can be used in conditions elsewhere; this allows you to use list boxes to control the installer's actions or component selection.
To define the list values that are shown in the control, right-click on the control and choose New List Value from the popup menu. This creates a new List Value item where you can define the display text and the associated value. Repeat this procedure for all the values that must go into the list.
The order in which the list values appear as children of the ListBox control in the Dialogs tree determines the order in which they appear in the control, unless you check the Sorted option (see below). You can move the list values up and down in the tree to change the list order.
Attributes
This pane contains the following attributes and options.
| Attribute | Description |
|---|---|
| Control ID |
Select a control ID from the drop-down list or type a numerical ID to use for this control. All controls within a dialog must have different control IDs. For ListBox controls, you should select Automatic. See Dialog Control IDs for an explanation of the available control IDs and their usage. |
| Name | Enter the internal name for the control. This name is for use in InstallMate only; it is not used in the installer. All control names must be unique within their parent dialog box. |
| Symbol name |
Enter the name of the symbolic variable to which the control must be linked, or click ... (browse) to open the Select Symbolic Variable dialog box that allows you to select a variable from the project. The control's will select the list item that corresponds to the value of the linked variable and will be updated automatically whenever the variable's value changes. Conversely, the variable's value will be updated if the user selects a different value from its list. |
| Indirect |
Check this box to make the Symbol name link indirect; clear it for a direct link. If the link is indirect, the variable specified in the Symbol name field is used to obtain the name of a second variable, and it is this second variable whose value is monitored and updated by the control. With a direct link, the variable specified by the Symbol name attribute itself is monitored and updated. |
| Condition |
Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog Control Conditions for more information. |
| Visible Enabled Tab stop Group Border Sunken Client edge Transparent Don't mirror |
These are all standard control styles; see Dialog Control Styles for a description. |
| Sorted | Check this box to sort the list values in the list alphabetically; clear it to keep them in the order in which they appear in the project. |