Icon attributes (MSI control)

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

Introduction

An Icon control displays icon images. The Tarma ExpertInstall dialog editor shows the selected icon image in the control. To display an icon image in an Icon control, you must add the desired icon on the Icons project page, then set the control's Icon name attribute to the name of the desired icon image.

Tarma note The Tarma Installer equivalent is the Icon control.

Attributes

This pane contains the following attributes and options.

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

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.

Tip: The Icon name attribute is localizable; you can use different images for different languages if you want.

Size

Select the desired icon size from the drop-down list.

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.

Help text Enter text for display in help tooltips.
Visible

Check this box to make the control initially visible; clear it to hide the control. You can change the visibility status of the control at installation time by using Control conditions.

Sunken Check this box to make the control appear sunken; clear it to display it flush with its parent dialog or billboard. A sunken control has a simulated 3D border.
Fixed size Check this box to display the icon image at its actual size; this may result in clipping or filling of it borders. Clear this box to stretch the icon image to fit the size of the control; this may result in a distorted image.
Don't mirror Check this box to keep the control's orientation as it is and not mirror it for languages that use a right-to-left (RTL) order; clear it to mirror the control if the parent dialog is mirrored for RTL languages. This option only has effect for languages that use an RTL reading order, such as Arabic and Hebrew; for other languages it is ignored.