Icon Control

Windows Installer

Icon Control

The Icon control displays a static picture of an icon. The background of the image is transparent.

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 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. Use installer units for length and distance.

Text Contains the name of an icon stored in the Binary table.

To display an icon that is stored in the Binary table enter the name of the image's record appearing in 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 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 0x00000000

0x00100000

Stretches the icon image to fit the control.

Crops or centers the icon image in the control.

Include this bit in the bit word of the Attributes column of the Control table.

IconSize 0x00000000

0x00200000

0x00400000

0x00600000

Loads the first image.

Loads the first 16x16 image.

Loads the first 32x32 image.

Loads the first 48x48 image.

An icon file can contain different size images of the same icon. Include the value of the appropriate bit word in the Attributes column of the Control table

If these bits are not set, the installer ignores the FixedSize attribute and the image is stretched to fit the control rectangle. If both the IconSize bits and the FixedSize bits are set, an image smaller than the control is centered and an image is larger than the control it is shrunk to fit.

 

Remarks

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

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.