Background About the Default Images on Dialogs in InstallScript and InstallScript MSI Projects

InstallShield 2024

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

Two types of images—the default banner images on interior dialogs, as well as the computer image on the left side of the exterior skinned dialogs such as the Welcome dialog—are used for static dialog user interface controls that have a control identifier of 1200. The default images are .png images, which allow for transparency. The Text field for these controls uses the following syntax by default to identify the image:

@@ResourceID;ScaleFactor

ResourceID indicates the resource identifier number that should be used to look up either a .png image (stored as resource type PNG) or a bitmap image (stored as resource type RT_BITMAP). ScaleFactor indicates the DPI scale percentage for which the image is intended.

For example, the scale factor can be 100% (96 DPI), 125% (120 DPI), 150% (144 DPI), or 200% (192 DPI). If the scale factor that is specified for an image is 200, the image will be shrunk down for display on target systems that are running less than 200% DPI scaling. On a 200% target system, it will be displayed at 1:1. If the scale factor that is specified for the image is100, the image will be scaled up for display on target systems that are running 200% DPI scaling.

The previous format for identifying bitmap images (.bmp) still works, but it does not have support for scaling, or for .png images:

@BitmapResourceID;TransparentFlag;3-DFlag;<unused>;TransparentColorKey

BitmapResourceID indicates the resource identifier number for the bitmap image. TransparentFlag is 1 (true) or 0 (false), indicating whether the color that is specified in the TransparentColorKey field will be transparent when the bitmap is displayed. TransparentColorKey specifies an RGB value that is a transparent color for the bitmap.

See Also