Bitmap Control

InstallShield 2016

Project • This information applies to the following project types:

•

Basic MSI

•

InstallScript

•

InstallScript MSI

•

InstallScript Object

•

Merge Module

A bitmap control displays an image.

When you select a bitmap control in a dialog of the Dialogs view, InstallShield displays the following settings in the right pane.

Settings for a Bitmap Control
Setting	Project Type	Description
Name	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Enter a name for this bitmap. The name must be unique among all of the controls in your project.
Cancel	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	If this is the only control on the dialog that will dismiss the dialog, select True. Clicking the cancel control has the same effect as pressing the ESC key or clicking the Close button on the title bar. The Cancel or Finish button is usually the cancel control. This value is ignored if True is selected for the ErrorDialog setting of the dialog that contains this control.
Context Help	Basic MSI, Merge Module	This setting is reserved for future use. Windows Installer does not currently support launching context-sensitive help topics from the installation.
Control Identifier	InstallScript, InstallScript MSI, InstallScript Object, Merge Module	This setting contains a numeric identifier for the control that is unique within the dialog. This identifier is the same as a resource identifier in Visual C++. You should not change the control identifiers for any of the controls that are included with a dialog by default.
Default	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Select True if this is the only control on the dialog that you want to be the default control, which means that it will be activated when the end user presses the ENTER key. The Next or OK button is usually the default control.
File Name	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Enter the path to and the name of the image file that you want to use for this control, or click the ellipsis button (...) in this setting to browse to it. InstallShield adds the file to your release at build time. The file must be stored as a binary resource in the installation.
Height	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	For Basic MSI and Merge Module projects: Specify the height of the control in Windows Installer user interface units (1/12 of the height of the system font). For InstallScript, InstallScript MSI, and InstallScript Object projects: Specify the height of the control in dialog units.
Left	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Specify the distance from the left edge of the dialog to the start of the control in installer units (1/12 of the height of the system font).
Other Window Styles	InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Click the ellipsis button (...) to display the Other Window Styles dialog box.
Stretch to Fit	Basic MSI, Merge Module	If you want the image to be resized to fill the area of the control, select True. To have the image centered if it is smaller than the control or to have the image cropped if it is bigger than the control, select False.
Sunken	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	To give the control’s edges a recessed, three-dimensional appearance, select True. To use the default visual style for the control, select False.
Tab Index	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Assign an integer that—along with the other controls on this dialog but excluding controls such as static text—specifies the order in which each control on the dialog receives focus when the end user presses the TAB key. The lowest tab index that you can use is the number 0.
Tab Stop	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Indicate whether this control receives focus within the tab order. True indicates that the control receives focus; False indicates that the control does not receive focus.
Tooltip	Basic MSI, Merge Module	Enter the text that you want to be displayed when the end user places the mouse pointer over the control. When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.
Top	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Specify the distance from the top of the dialog to the top of the control in installer units (1/12 of the height of the system font).
Visible	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	True means that the control is visible, and False means that it is hidden. You can also make the control visible by editing its condition in the Behavior area for the dialog.
Width	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	For Basic MSI and Merge Module projects: Specify the width of the control in Windows Installer user interface units (1/12 of the height of the system font). For InstallScript, InstallScript MSI, and InstallScript Object projects: Specify the width of the control in dialog units.

Bitmap Control

InstallShield 2016 Help Library

August 2016