RadioButton attributes (MSI)

Reference information
Project page	Dialogs and Billboards
Related topics	Working with attribute panes
External links	Windows Installer documentation

Reference information

Project page

Dialogs and Billboards

Related topics

Working with attribute panes

External links

Windows Installer documentation

Introduction

A RadioButton control is part of a RadioButtonGroup control that represents a mutually exclusive set of choices. Each RadioButton control consists of a selection box with a text label, bitmap, or icon image to the right of it. 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 Type and set the control's Text/Image attribute to the name of the desired bitmap or icon image.

Note: Even though Tarma ExpertInstall allows you to select different label types for the RadioButton controls in a group, the Windows Installer design requires that all controls in a group use the same type: text, bitmap, or icon. Tarma ExpertInstall uses the label type of the first RadioButton control in a group for all controls in that group.

Windows Installer can display bitmaps in Bitmap (.bmp), JPEG (.jpg) and Portable Network Graphics (.png) formats. The current version of Tarma ExpertInstall can only handle .bmp bitmap images. You can use the other types as well, but they won't be displayed in Tarma ExpertInstall. We intend to add support for JPEG and PNG images in a future release of Tarma Installer.

You cannot create RadioButton controls directly in a dialog box; you must create a RadioButtonGroup control first, then add the desired RadioButton controls to this group by right-clicking on the group control and choosing New List Value from the popup menu for each RadioButton control that you want to add to the group.

The Tarma Installer equivalent is the RadioButton control; these do not require an additional radio button group control.

Attributes

Attribute	Description
Control name	Enter the name of the control. This name has no special significance, but it must be unique among all controls of its parent dialog or billboard.
Type	Select the desired RadioButton type from the drop-down list: Text - Displays a text string in the control Bitmap - Displays a bitmap image in the control Icon - Displays an icon image in the control Note: Due to the design of Windows Installer, the Type of the first radio button in a group is used for all buttons in the group.
Text/Image	Depending on the 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.
Size	Select the desired icon size from the drop-down list. This option only applies if 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. Note: Due to the design of Windows Installer, the Size of the first radio button in a group is used for all buttons in the group.
Help text	Enter text for display by screen readers. This text is not normally visible, but it can be read by screen reader software such as used by visually impaired users.
Value	Enter the value to assign to the parent group's linked property when the current RadioButton control is selected.
Fixed size	Check this box to display the bitmap image at its actual size; this may result in clipping or filling of it borders. Clear this box to stretch the bitmap image to fit the size of the control; this may result in a distorted image. This option only applies if Type is set to Bitmap. Note: Due to the design of Windows Installer, the Fixed size setting of the first radio button in a group is used for all buttons in the group.
Push like	Check this box to make the RadioButton control appear similar to a PushButton control; clear it to to display it as a radio button. When the RadioButton control appears as a push button, its "selected" state is shown as a pushed-in button and its "deselected" state as a popped-up button. Note: Due to the design of Windows Installer, the Push like setting of the first radio button in a group is used for all buttons in the group.

Attribute

Description

Control name

Enter the name of the control. This name has no special significance, but it must be unique among all controls of its parent dialog or billboard.

Type

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

Text - Displays a text string in the control
Bitmap - Displays a bitmap image in the control
Icon - Displays an icon image in the control

Note: Due to the design of Windows Installer, the Type of the first radio button in a group is used for all buttons in the group.

Text/Image

Depending on the 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.

Size

Select the desired icon size from the drop-down list. This option only applies if 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.

Note: Due to the design of Windows Installer, the Size of the first radio button in a group is used for all buttons in the group.

Help text

Enter text for display by screen readers. This text is not normally visible, but it can be read by screen reader software such as used by visually impaired users.

Value

Enter the value to assign to the parent group's linked property when the current RadioButton control is selected.

Fixed size

Check this box to display the bitmap image at its actual size; this may result in clipping or filling of it borders. Clear this box to stretch the bitmap image to fit the size of the control; this may result in a distorted image. This option only applies if Type is set to Bitmap.

Note: Due to the design of Windows Installer, the Fixed size setting of the first radio button in a group is used for all buttons in the group.

Push like

Check this box to make the RadioButton control appear similar to a PushButton control; clear it to to display it as a radio button. When the RadioButton control appears as a push button, its "selected" state is shown as a pushed-in button and its "deselected" state as a popped-up button.

Note: Due to the design of Windows Installer, the Push like setting of the first radio button in a group is used for all buttons in the group.

Documentation Home | Using Tarma ExpertInstall | Knowledge Base
Tarma ExpertInstall User's Manual - Topic last modified on 21/01/08 11:03
Copyright © 1990-2008 Tarma Software Research. All rights reserved.