Edit

Bitmap Control

  • Article

The Bitmap control displays a bitmap or JPEG static picture file. The Windows Installer will automatically determine the format of the binary data and display the picture. The control does not support animation.

Windows 8 and Windows Server 2012: The image file can be in any standard format supported by the Windows Imaging Component (WIC), including TIFF, JPEG, PNG, GIF, BMP, and HDPhoto. The control does not support animation.

Control Attributes

You can use the following attributes with this control. To change the value of an attribute using an event, subscribe the control to a ControlEvent in the EventMapping table and list the attribute's identifier in the Attribute column. Enter the identifier of the ControlEvent in the Event column.

Attribute identifier Hexadecimal bit Description
Position Position of the control in the dialog box. Enter the control's width, height, and coordinates of the control's left corner into the Width, Height, X, and Y columns of the Control table or BBControl table. Use installer units for length and distance.
Text Contains the name of a bitmap stored in the Binary table. To display a bitmap stored in the Binary table, do the following. Enter the name of the bitmap image appearing in the Name column of the Binary table into the Text column of the Control table record for this control.
Visible 0x00000000 0x00000001
 Hidden control. Visible control.
Include this bit in the bit word of the Attributes column in the Control table or BBControl table.to make the control visible or hidden upon its creation.
You can also hide or show a control by using the ControlCondition table.
Sunken 0x00000000 0x00000004
 Displays the default visual style. Displays the control with a sunken, 3-D look.
Include these bits in the bit word in the Attributes column of the Control table.
FixedSize control 0x00000000 0x00100000
 Stretches the bitmap image to fit the control. Crops or centers the bitmap image in the control.
Include this bit in the bit word of the Attributes column of the BBControl table or the Control table.

Remarks

This control can be created from the STATIC class by using the CreateWindowEx function. It has the SS_BITMAP, SS_CENTERIMAGE, WS_CHILD, and WS_GROUP styles.