Bitmap Control attributes

A Bitmap control displays bitmap images. The InstallMate 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 attribute to the name of the desired bitmap image.

Attributes

This pane contains the following attributes and options.

Attribute Description
Control ID

Select a control ID from the drop-down list or type a numerical ID to use for this control. All controls within a dialog must have different control IDs. For most controls, you should select Automatic; for PushButton controls, one of the standard IDxxx values is generally recommended.

See Dialog Control IDs for an explanation of the available control IDs and their usage.

Name Enter the internal name for the control. This name is for use in InstallMate only; it is not used in the installer. All control names must be unique within their parent dialog box.
Display mode

Select the desired bitmap display mode from the drop-down list. The following choices are available:

Display mode Description
Stretch Stretch or shrink the bitmap image to fit the size of the Bitmap control. This might result in a distorted image.
Centered Center the bitmap image inside the Bitmap control. If the bitmap image is larger than the available control size, it will be clipped; if smaller, the remaining control area will be filled with the color of the bitmap image's top-left pixel.
Actual size Resize the control to fit the bitmap image's size.

The size of bitmap images is determined by the number of horizontal and vertical pixels that they contain. However, the size of Bitmap controls is expressed in "dialog units", which are based on the font used in their parent dialog. Different dialog fonts result in different dialog unit to pixel size mappings. As a result, a bitmap image that fits exactly when one font is used, might no longer fit with a different font.

For the best result in most situations, we recommend using the Centered option and a bitmap image that is somewhat larger than required for the Bitmap control.

Note: Even if you use the same dialog font throughout, the actual font at installation time might vary, in particular if the dialog font is set to MS Shell Dlg or MS Sans Serif. Furthermore, fonts such as Tahoma and Verdana that are used on Windows 2000 and later, are not available on earlier Windows versions. On those versions, another font such as Arial or MS Sans Serif is substituted, which leads to slightly different dialog and control sizes.

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.

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

Condition

Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog Control Conditions for more information.

Note: This has no effect on Bitmap controls.

Visible
Enabled
Tab stop
Group
Border
Sunken
Client edge
Transparent
Don't mirror
These are all standard control styles; see Dialog Control Styles for a description.

Related topics

Installer Dialogs, Working with attribute panes