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.