RadioButton Control attributes

A RadioButton control is part of a group that represents mutually exclusive options. It displays a selection box plus a text label, bitmap, or icon image. To display a bitmap or icon image in a RadioButton control, you must add the desired bitmap or icon on the Bitmaps or Icons project page, then select the control's Caption type and set the control's Caption attribute to the name of the desired bitmap or icon image.

Each RadioButton control is linked to a symbolic variable. When a RadioButton control is selected, the linked variable's value is set to the value specified by the Checked attribute (see below). The variable itself can be used in conditions elsewhere; this allows you to use radio buttons to control the installer's actions or component selection.

To create a group of radio buttons, do the following:

Create a RadioButton control for each option. Place the controls in the order that you want to present them, both visually and in the Dialogs tree on the Installer Dialogs page.
Check the Group attribute of the first RadioButton control in the group; clear it for all other radio buttons in the same group. Also check the Group attribute of the first control after the last radio button in the group.
Set the Symbol name of all radio buttons in the group to same variable. Also make sure that all radio buttons have their Indirect attribute in the same state: either all checked or all unchecked.
Assign the appropriate Checked value to each of the radio buttons in the group.

Tip: If space is at a premium, you can replace a group of RadioButton controls by a single ComboBox control with its Combo style set to Drop list and List Values corresponding to each of the radio buttons.

When running on Windows XP and later with visual themes enabled, RadioButton 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 type

Select the desired caption type from the drop-down list:

Text - Displays a text string next to the radio button
Bitmap - Displays a bitmap image next to the radio button
Icon - Displays an icon image next to the radio button

Caption

Depending on the Caption type selection, enter one of the following:

Text - Enter the text string to display
Bitmap - Enter the name of the bitmap image to display in the control, or click ... (browse) to open the Select Bitmap Image dialog that allows you to select a bitmap from the project's bitmaps.
Icon - Enter the name of the icon image to display in the control, or click ... (browse) to open the Select Icon dialog that allows you to select an icon from the project's icons.

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 named variable is set to the Checked value when the RadioButton control is selected.

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 changed by the control. With a direct link, the variable specified by the Symbol name attribute itself is changed.

Checked

Enter the value that must be assigned if the RadioButton control is selected.

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.

Multiline

Check this box to allow the control's caption to wrap around to the next line if the text width exceeds the control's width; clear it to restrict the caption to a single line. In the latter case, it will be clipped if it exceeds the control's width.

Flat

Check this box to make the radio button appear flat; clear it for a beveled 3D edge.

Note: This option does not have any effect when used under Windows XP with visual themes enabled; however, if you also select Transparent, the control reverts to its non-themed appearance and Flat can be used.

Right button

Check this box to display the radio button to the right of the caption; clear it to display the radio button to the left.

Push-like

Check this box to make the radio button appear as a PushButton control; clear it for a regular radio button. With this option checked, the control's "selected" state appears as a pushed-in button; its "deselected" state is a popped-up button.

Select the desired horizontal alignment of the control's caption from the drop-down list.

Select the desired vertical alignment of the control's caption from the drop-down list.

Icon size

Select the desired icon size for the control. This option only has effect if the Caption type is set to Icon.

Note: If the selected image size is not present in the icon file, then the system scales one of the other icon images to the desired size. The resulting image may be less than satisfactory; in that case, you should edit the original icon file and add an image of the required size.

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.

RadioButton Control attributes

Attributes

Related topics