InstallShield 2019
Project • This information applies to the following project types:
• | Basic MSI |
• | InstallScript |
• | InstallScript MSI |
• | InstallScript Object |
• | Merge Module |
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.
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). |
||||||
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 • 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.
|
|||||||
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
InstallShield 2019 Help LibraryApril 2019 |
Copyright Information | Flexera |