Group Box Control
InstallShield 2022
Project:This information applies to the following project types:
| • | Basic MSI |
| • | InstallScript |
| • | InstallScript MSI |
| • | InstallScript Object |
| • | Merge Module |
A group box can be used to enclose various controls in one area. To move and align the group box along with any individual control that it encloses, hold the CTRL key as you select the group box and each control that you want to select. A group box also provides a label that you can use to express the relationship between the controls that are contained within it.
When you select a group box control in a dialog of the Dialogs view, InstallShield displays the following settings in the right pane.
|
Setting |
Project Type |
Description |
|
Name |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Enter a name for this group box. The name must be unique among all of the controls in your project. |
|
Base Text Style |
Basic MSI, Merge Module |
This font style is used for the control’s label if you specify nothing for the Text Style setting. |
|
Cancel |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
If this is the only control on the dialog that will dismiss the dialog, select True. Clicking the cancel control has the same effect as pressing the ESC key or clicking the Close button on the title bar. The Cancel or Finish button is usually the cancel control. This value is ignored if True is selected for the ErrorDialog setting of the dialog that contains this control. |
|
Context Help |
Basic MSI, Merge Module |
This setting is reserved for future use. Windows Installer does not currently support launching context-sensitive help topics from the installation. |
|
Control Identifier |
InstallScript, InstallScript MSI, InstallScript Object |
This setting contains a numeric identifier for the control that is unique within the dialog. This identifier is the same as a resource identifier in Visual C++. You should not change the control identifiers for any of the controls that are included with a dialog by default. |
|
Default |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
If this is the only control on the dialog that you want to be the default control, which means that it is activated when the end user presses the ENTER key, select True. The Next or OK button is usually the default control. |
|
Enabled |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Indicate whether the control is enabled. True means that this control is available (the end user can interact with it). False means that it is not available (grayed out). |
|
Height |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
For Basic MSI and Merge Module projects: Specify the height of the control in Windows Installer user interface units (1/12 of the height of the system font). For InstallScript, InstallScript MSI, and InstallScript Object projects: Specify the height of the control in dialog units. |
|
Left |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the distance from the left edge of the dialog to the start of the control in installer units (1/12 of the height of the system font). |
|
Other Window Styles |
InstallScript, InstallScript MSI, InstallScript Object |
Click the ellipsis button (...) to display the Other Window Styles dialog box. |
|
Right-Aligned |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
The default value of False aligns the text to the left of the control. Set it to True to align the text to the right. |
|
Right-to-Left |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
For English and other languages that are written from left to right, select False. For Hebrew and those languages that are read from right to left, select True. |
|
Sunken |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
To give the control’s edges a recessed, three-dimensional appearance, select True. To use the default visual style for the control, select False. |
|
Tab Index |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Assign an integer that—along with the other controls on this dialog but excluding controls such as static text—specifies the order in which each control on the dialog receives focus when the end user presses the TAB key. The lowest tab index that you can use is the number 0. |
|
Tab Stop |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Indicate whether this control receives focus within the tab order. True indicates that the control receives focus; False indicates that the control does not receive focus. |
|
Text |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
This setting contains the text that is used for the group box label. 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. |
|
Text Style |
Basic MSI, Merge Module |
Select the font style, size, and color (if available) in which you want the control’s label to be displayed. Leaving the value as <Default> displays the font that is contained in the DefaultUIFont property. |
|
Tooltip |
Basic MSI, Merge Module |
Enter the text that you want to be displayed when the end user places the mouse pointer over 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. |
|
Top |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the distance from the top of the dialog to the top of the control in installer units (1/12 of the height of the system font). |
|
Visible |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
True means that the control is visible, and False means that it is hidden. You can also make the control visible by editing its condition in the Behavior area for the dialog. |
|
Width |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
For Basic MSI and Merge Module projects: Specify the width of the control in Windows Installer user interface units (1/12 of the height of the system font). For InstallScript, InstallScript MSI, and InstallScript Object projects: Specify the width of the control in dialog units. |
See Also