Bitmap attributes (MSI control)

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

Introduction

A Bitmap control displays bitmap images. The Tarma ExpertInstall dialog editor shows the selected bitmap image in the control. To display a bitmap image in a Bitmap control, you must add the desired bitmap on the Bitmaps project page, then set the control's Bitmap name attribute to the name of the desired bitmap image.

TODO note Windows Installer can display bitmaps in Windows 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.

Tarma note The Tarma Installer equivalent is the Bitmap 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.
Bitmap name

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.

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

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