InstallShield 2016
Project • This information applies to the following project types:
| • | Advanced UI |
| • | Suite/Advanced UI |
Edition • The Advanced UI project type is available in the Professional edition of InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.
InstallShield lets you add to the wizard interface one or more combo box controls and list box controls with predefined selectable options. The process involves configuring the control’s settings to define the content for the selectable options. The process also involves the use of two properties: one that defines the list of options that you want to display in the control, and one that the installation uses to store the option that the end user selects at run time.
To populate a combo box control or a list box control with predefined options:
| 1. | Associate the control with two properties: one that defines the list of options that you want to display in the control, and one that the installation uses to store the option that the end user selects at run time: |
| a. | In the View List under User Interface, click Wizard Interface. |
| b. | In the Wizard Interface explorer, expand the wizard page or secondary window that you want to modify, and then select the combo box control or list box control that you want to configure. |
| c. | In the Property setting, enter the name of the Advanced UI or Suite/Advanced UI property—for example, SELECTIONPROPERTY—that you want to associate with the control. At run time, the installation uses this property to store the value that the end user selects. |
| d. | In the Content Property setting, enter the name of the Advanced UI or Suite/Advanced UI property that you want to use to identify the options that you want to list in this control—for example, CONTROLOPTIONS. |
| 2. | Define the list of options that you want to display in the combo box control or the list box control: |
| a. | In the Content Property setting, click the ellipsis button (...). The Edit List Options dialog box opens. |
| b. | In the Text column, enter one of the options that you want to display in the control. |
When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.
| c. | In the Value column, enter the value that you want to associate with the list option text that you entered in step 2b. This is the property value that is stored in SELECTIONPROPERTY—the property that you entered in step 1c—if the end user selects the list option that you entered in the Text column. |
| d. | To add additional text-value pairs, click the New button, and then complete the fields in the row that InstallShield adds. |
For example, you might enter the following data:
|
Text |
Value |
|
ID_Option1 |
Value1 |
|
ID_Option2 |
Value2 |
|
ID_Option3 |
Value3 |
| e. | Change the order of the list options if appropriate. |
The installation displays the list options in the order that you list them on this dialog box. To change the order of the list options, select a row, and then click the Up or Down buttons as needed. To select multiple consecutive rows, click the first row, press and hold Shift, and then click the last row. To select multiple non-consecutive rows, click one of the rows, press and hold down CTRL, and then click each additional row.
| 3. | Click OK. |
Specifying the Default Option for the Combo Box Control or the List Box Control
If you want to specify the default option for a combo box control or a list box control, use the Property Manager view to set the value of the Advanced UI or Suite/Advanced UI property equal to the property value that corresponds with the default selectable option. Thus, if you want ID_Option3 to be selected by default, add the SELECTIONPROPERTY property to the Property Manager view, and set its value to Value3. To leave the control blank by default, do not define the property in the Property Manager view.
Working with End-User Data from a Combo Box Control or a List Box Control
At run time, end users can make a single selection from the combo box or the list box; this sets the control’s property (which is SELECTIONPROPERTY in the aforementioned procedure) to the value that is associated with the selected option—for example, Value1, Value2, or Value3. You can trigger different types of behavior based on the value of the SELECTIONPROPERTY property. Examples are:
| • | You can enable or disable a control on the wizard page or secondary window. To do this, use the control’s Enabled setting to define a Property type of condition and tie the enabled state of the control to a particular value of the property. |
| • | You can display or hide a particular control on a wizard page or secondary window. To do this, use the control’s Visible setting to define a Property type of condition and tie the enabled state of the control to a particular value of the property. |
| • | You can display or skip a particular wizard page or secondary window. To do this, use the wizard page’s or secondary window’s Visible setting to define a Property type of condition and tie the enabled state of the wizard interface to a particular value of the property. |
| • | You can use the value of the Advanced UI or Suite/Advanced UI property to set a particular property in a package in the Advanced UI or Suite/Advanced UI installation. To do this, use the command line and silent command line settings that are available as subsettings in the Operation area of the grid in the Packages view. For more information, see Using Advanced UI and Suite/Advanced UI Formatted Expressions to Dynamically Configure Command Lines. |
See Also
Adding a Control to a Wizard Page or Secondary Window
InstallShield 2016 Help LibraryAugust 2016 |
Copyright Information | Flexera Software |