GroupBox control
A GroupBox control is used to frame a number of closely related other controls in a dialog box. Its effect is only visual; there is no parent/child relationship between the GroupBox control and the controls that it encloses.
When running on Windows XP and later with visual themes enabled, GroupBox controls appear not themed if:
- The control has a transparent background (Transparent attribute, see below), or
- The control has a non-default text color (Text color attribute, see below).
Tip: To change the tab and Z-order of a control in a dialog box (i.e., the order in which they are drawn and how they appear "on top" of each other), select the control in the dialog/control tree in the left pane on the Dialogs project page, then use Ctrl+Up and Ctrl+Down to move the control up or down in the order. These keystrokes are shortcuts for the Move Up and Move Down commands on the control's context menu.
Attributes
The following attributes and options are available.
| Attribute | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Control 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. | ||||||||||||||||||||||
| 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 most controls, you should select Automatic; for PushButton controls, one of the standard IDxxx values is generally recommended. See Dialog control IDs for an explanation of the available control IDs and their usage. |
||||||||||||||||||||||
| Caption | Enter the text to display as the control's caption. | ||||||||||||||||||||||
| Localized | Check this box to localize the Caption field and use different captions for different languages. | ||||||||||||||||||||||
| Flat | Check this box to make the GroupBox' frame appear flat; clear it for a beveled 3D edge. | ||||||||||||||||||||||
| Font | Select the font style for the text in the control by clicking ... (browse) to open the Select Font Style dialog. If no font style is selected, the control uses the parent dialog's font style. You can remove the font style by clicking X (clear). | ||||||||||||||||||||||
| Text color | Select the desired text color from the drop-down list. The following choices are available:
Note: The actual display colors depend on the Windows' settings. If the user has selected a different color scheme, then the control will use the appropriate colors from that scheme. |
||||||||||||||||||||||
| Background | Select the desired background color from the drop-down list. The following choices are available:
Note: The actual display colors depend on the Windows' settings. If the user has selected a different color scheme, then the control will use the appropriate colors from that scheme. Note: If you select the Transparent option, then the Background color option will be ignored. |
||||||||||||||||||||||
| Horizontal align | Select the desired horizontal alignment for the control's caption. | ||||||||||||||||||||||
| Enabled Tab stop Group Border Sunken Client edge Visible Transparent Don't mirror |
These are all standard control styles; see Dialog control styles for a description. Note: If you select Transparent, then the Background color option will be ignored. |
||||||||||||||||||||||
| Condition | Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog control conditions for more information. |