Dialog Control
InstallShield 2020
Project:This information applies to the following project types:
| • | Basic MSI |
| • | InstallScript |
| • | InstallScript MSI |
| • | InstallScript Object |
| • | Merge Module |
When you select a dialog in the Dialog Editor of the Dialogs view, InstallShield displays the following settings in the right pane.
Unlike its controls, you cannot change the name of a dialog in the Dialog Editor. To change the name, right-click the dialog in the Dialogs view and click Rename.
|
Setting |
Project Type |
Description |
|
Caption |
Basic MSI, Merge Module |
Specify the name that you want to use as the title for the dialog. 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. |
|
Comment |
Basic MSI, Merge Module |
Enter comments for the dialog. Your comments are saved in the project file for your reference and are not used in the installation at any time. |
|
Custom Palette |
Basic MSI, Merge Module |
A custom palette is necessary only if the dialog contains images that use a color palette that is different from the default one that is created by Windows Installer. If the dialog does not contain any images that use a different color palette, leave this value as False. |
|
Error Dialog |
Basic MSI, Merge Module |
If this dialog serves as an error dialog, select True. |
|
Height |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the height of the dialog in installer units (1/12 of the height of the system font). |
|
Keep Modeless |
Basic MSI, Merge Module |
When this value is set to True and this dialog is spawned through a DoAction event, all other dialogs remain. If the Keep Modeless setting is False in this case, the other dialogs are not displayed. |
|
Left |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the percentage from the left edge of the screen where you want the dialog to be placed. A value of 50 centers the dialog horizontally. This value is ignored if this dialog is part of an installation wizard, and the previous dialog was in a different location or was moved by the end user. |
|
Left Scrollbar |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Select True to set the scroll bar, if present, at the left side of the dialog. The default value, False, keeps it at the right side. If you want the vertical scrollbar, if present, to be displayed on the left side of the dialog, select True. The default value, False, keeps the scrollbar on the right side. |
|
Minimize |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
True means that the end user can minimize this dialog. False means that the option is not present on the title bar. |
|
Modal |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Select True if this dialog is part of the installation wizard and no other dialogs should be placed on top of it. |
|
Other Window Styles |
InstallScript, InstallScript MSI, InstallScript Object |
Click the ellipsis button (...) to display the Other Window Styles dialog box. |
|
Resource Identifier |
InstallScript, InstallScript MSI, InstallScript Object |
This read-only setting shows the dialog’s resource ID—the unique numeric identifier for the dialog. |
|
Right-Aligned |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
The default value of False aligns the caption to the left of the control. Set it to True to align the caption to the right. |
|
Right-to-Left |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
For English and other languages that are written from left to right, select False. For Hebrew and those languages that are read from right to left, select True. |
|
Text Style |
InstallScript, InstallScript MSI |
Select a font to be used for the dialog. |
|
Top |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the percentage from the top of the screen where you want the dialog to be placed. A value of 50 centers the dialog vertically. This value is ignored if this dialog is part of an installation wizard, and the previous dialog was in a different location or was moved by the end user. |
|
Track Disk Space |
Basic MSI, Merge Module |
Select True if this dialog has a control that alerts the end user that a drive is out of space or that checks the value of the OutOfDiskSpace property before performing some action. |
|
Visible |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
True means that the dialog is visible, and False means that it is hidden. |
|
Width |
Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module |
Specify the width of the dialog in installer units (1/12 of the height of the system font). |
See Also