GroupBox Control attributes

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 (Color attribute, see below).

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 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.

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.

Caption

Enter the text to display as the control's caption.

Condition

Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog Control Conditions for more information.

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).

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.

Note: If you select Transparent, then the Backgnd color option (see below) will be ignored.

Flat

Check this box to make the GroupBox' frame appear flat; clear it for a beveled 3D edge.

Align

Select the desired horizontal alignment for the control's caption.

Color

Select the desired text color from the drop-down list. The following choices are available:

Color	Description
Default	Use the system color for text in dialog boxes, usually black (COLOR_BTNTEXT).
Black	Use the system color for text in windows, usually black (COLOR_WINDOWTEXT).
White	Use the system color for text in window captions, usually white (COLOR_CAPTIONTEXT).
Hyperlink	Use the color for hyperlink text; this is currently fixed at blue.
Gray	Use the system color for grayed-out text, usually gray (COLOR_GRAYTEXT)
Custom...	Use a custom color. Click the ... (choose color) button to open the standard Color dialog box, where you can choose the desired color.

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.

Backgnd

Select the desired background color from the drop-down list. The following choices are available:

Color	Description
Default	Use the system color for dialog box backgrounds, usually light gray (COLOR_3DFACE).
Dark gray	Use the system color for shadows, usually dark gray or black (COLOR_3DSHADOW).
Light gray	Use the system color for buttons, usually light gray (COLOR_BTNFACE).
White	Use the system color for window backgrounds, usually white (COLOR_WINDOW).
Caption	Use the system color for window captions, usually blue (COLOR_CAPTION).
CaptionEnd	Use the system end color for windows captions with a color gradient, usually light blue (COLOR_GRADIENTACTIVECAPTION).
Workspace	Use the system color for application workspaces, usually dark gray (COLOR_WORKSPACE).
Desktop	Use the system color for the Desktop, usually blue or green (COLOR_DESKTOP).
Info	Use the system color for info tip windows, usually pale yellow (COLOR_INFOBK).
Custom color...	Use a custom color. Click the ... (choose color) button to open the standard Color dialog box, where you can choose the desired color.

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 (above), then the Backgnd color option will be ignored.

GroupBox Control attributes

Attributes

Related topics