Summary

The article discusses key points to follow when making and configuring custom dialogs in both Basic MSI Projects and InstallScript MSI projects.

Synopsis

The article discusses key points to follow when making and configuring custom dialogs in both Basic MSI Projects and InstallScript MSI projects.

Discussion

InstallScript MSI Project

In an InstallScript MSI project, when adding a new dialog in the Dialog Editor, it is also added to the Dialog table as seen in the Direct Editor. In the Dialog table, a ResourceID can be specified for this dialog, which is then used within the script to identify this dialog.

Once the dialog has been added, functions, such as EzDefineDialog and WaitOnDialog, need to be called to load this dialog in memory and display it at run time. The ResourceID from the Dialog table is used as the fourth argument of EzDefineDialog to reference the custom dialog. Also, in the second argument of EzDefineDialog, it is advantageous to specify ISUSER as opposed to a null string. The EzDefineDialog function should look like:

EzDefineDialog("MyCustomDialog", ISUSER, "", 12005)

Where 12005 is the ISResourceID of this custom dialog in the Dialog table as seen in the Direct Editor.

Custom dialog functions can then be called to manipulate the custom dialog to your needs. These functions are documented in the InstallShield Language Reference.

Basic MSI Project

When making a custom dialog in Basic MSI Project?s Dialog Editor, an MSI type dialog is created. InstallScript custom dialog functions cannot be used with this MSI type dialog. To display this dialog in your setup, it must be placed in sequence between two dialogs by using their Next and Back controls.

Additional Information

The following articles discuss making and configuring custom dialogs:

• InstallShield Help Library topics:
  • Editing Dialog Layout in Basic MSI Projects
  • Editing Dialog Behavior in Basic MSI Projects
  • Modify Dialogs for Each Language
  • Displaying Dialogs During Installation in Basic MSI Projects
  • Viewing End-User Dialog Order in the Sequences View (Basic MSI Setup Projects)
• InstallShield Language Reference topics:
  • Built-In Functions by Category