Icon control

An Icon control displays icon images. The InstallMate dialog editor shows the selected icon image in the control. To display an icon image in an Icon control, you must add the desired icon on the Icons project page, then set the control's Icon name attribute to the name of the desired icon image.

Tip: To change the tab and Z-order of a control in a dialog box (i.e., the order in which they are drawn and how they appear "on top" of each other), select the control in the dialog/control tree in the left pane on the Dialogs project page, then use Ctrl+Up and Ctrl+Down to move the control up or down in the order. These keystrokes are shortcuts for the Move Up and Move Down commands on the control's context menu.


The following attributes and options are available.

Attribute Description
Control 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.
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.

Icon image

Enter the name of the icon image to display in the control, or click ... (browse) to open the Select Icon dialog that allows you to select an icon from the project's icons.

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

Localized Check this box to localize the Icon image field and use different icon images for different languages.
Icon size

Select the desired icon size from the drop-down list.

Note: If the selected image size is not present in the icon file, then the system scales one of the other icon images to the desired size. The resulting image may be less than satisfactory; in that case, you should edit the original icon file and add an image of the required size.

Stretch icon Check this box to stretch the icon image to fit the size of the control; this may result in a distorted image. Clear this box to display the icon image at its actual size; this may result in clipping or filling of it borders.
Tab stop
Client edge
Don't mirror

These are all standard control styles; see Dialog control styles for a description.


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

Related topics

Icons, Dialogs, Working with attribute panes