PreviousNext
Help Library

Radio Button Control

InstallShield 2011

Project-Specific

Project

This information applies to the following project types:

A radio button control is one of two or more mutually exclusive options that end users can select. A radio button must be inserted into a radio button group; it functions as part of that control.

A radio button group and its radio buttons behave as a single control. It is not possible to hide or disable individual buttons within a radio button group. All the buttons in a group must be the same style—for example, either all of them have text or all of them have bitmaps.

Note that when you delete a radio button group, all of its radio buttons are also deleted. In addition, when you change the name of the radio button group control, all of its radio buttons are deleted.

When you select a radio button control in a dialog of the Dialogs view, InstallShield displays the following settings in the right pane.

Settings for a Radio Button Control 

Setting

Project Type

Description

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.

The control identifier for the first radio button in a group is the control identifier for the radio button group. The control for each subsequent radio button is the radio button group identifier incremented by one.

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

Order

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Specify the number that indicates the order in which this radio button is listed in the radio button group. This setting must contain a unique, positive integer, but it does not need to be consecutive with the Order setting of the other radio buttons in this group.

Text

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

This setting contains the text that is used for the radio button’s 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).

Value

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Enter the value that you want to be associated with this radio button when end users select it.

Project-Specific Note

For Basic MSI projects: To make one of the radio buttons selected by default, enter the radio button group’s Windows Installer property in the Property Manager view. Type the property in all uppercase letters if you want it to be public in scope.Then, specify the value of the button that you want to appear as the default. For example, if one of your radio buttons has a value of 104 and the radio button group uses the property GRP_PROPERTY1, enter the following information in the Property Manager view to make this radio button the default selection.

  • Name: GRP_PROPERTY1
  • Value: 104

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




Copyright Information | Contact Us