In this page you can customize the user interface that will be displayed during the installation process.

In the left-side pane you can see a list with all the dialogs that will be used during your package installation, grouped in the following categories:

  • First Time Install (this category will be available only in a "Simple" or "Professional" project type.)
  • Maintenance
  • Patch
  • Resume
  • Administrative Dialogs
  • Special Dialogs
  • Unused Dialogs

You can modify the position of a dialog only inside one group by drag and drop. You can add some new dialogs and delete the dialogs you added.

ImportantSome dialogs cannot be moved from their position because they would disrupt the dialog sequence.

Caution!Dialogs with their name bold define the start of a dialog sequence. A dialog sequence refers to a set of dialogs that are displayed during the same Standard Action. For example: WelcomeDlg, FolderDlg, VerifyReadyDlg are all part of the InstallUISequence WelcomeDlg Standard Action. Dialogs triggered by control events have a lightning symbol on their icon.

First Time Install

Welcome Dialog

The first dialog displayed during install. It is used to inform the user about the application which will be installed on the target machine.

Select Installation Folder Dialog

Allows the user to select the folder where the package will be installed.

Ready to Install Dialog

Allows the user to proceed with the installation.

Installation Progress Dialog

The dialog containing the progress bar that shows the installation's evolution.

Installation Complete Dialog

The dialog displayed at the end of an installation. In the bottom pane you can choose if the user has the possibility to view the ReadMe file and/or launch your application after the installation finishes. You must specify the location for the Readme file and the application executable.

You can add twelve more dialogs to this group:

1. File Associations Dialog (ExtRegDlg)

The dialog asks the user to confirm the file associations' creation. The available options allow the user to create all or none of the file associations.

TipIf you want the user to be able to select which file associations to register, you should use the “FileAssociationsDlg” dialog.

NoteThis dialog is not available in a "Simple" project.

2. File Associations Dialog (FileAssociationsDlg)

This dialog will enable you to select which of the file associations you want to register. In order to use this dialog, go to “File Associations” under “Resources” and select the desired File Extension. In the “Extension Properties” page of the selected element, be sure to enable "Show in FileAssociationsDlg dialog" option.

NoteFor more information, please see File Associations Page. This dialog is not available in a "Simple" project.

3. Install Type Dialog

This dialog will allow the user to choose where the application will be installed :

  • Local User - The application will be available only for the user who runs the installation package. This is the only option available if the user has no administrator privileges.
  • All Users - The application will be available for all users. For this type of installation, a user with administrator privileges is required.

NoteThis dialog is not available in a "Simple" project.

4. License Agreement Dialog

Displays the license agreement text for your product. In the bottom pane you can select a Rich Text Format file that contains your license agreement. You can localize the License Agreement text.

5. Logon Information Dialog

This dialog can be used when the logon credentials are needed to during the application's installation process. The dialog is composed of the following fields:

  • User Name - the string will be saved in the USER_NAME property.
  • Domain - the string will be saved in the DOMAIN_NAME property.
  • Password - the string will be saved in the USER_PASSWORD property.

6. Prerequisites Dialog

This dialog will let the user select which prerequisites to install. It will display all the needed prerequisites, will install those missing and skip those found on the machine.

NoteThis dialog is not available in a "Simple" project.

7. ReadMe Dialog

Displays the ReadMe text for the user. In the bottom pane you can select a Rich Text Format file that contains your readme text. You can localize the ReadMe text.

8. Setup Type Dialog

Allows the user to select the installation's type. This dialog and the Select Installation Folder dialog are mutually exclusive.

  • Typical - only the most used product features will be installed.
  • Custom - allows the user to individually select which features will be installed and how they will be installed.
  • Complete - all the product's features will be installed.

NoteYou can set a feature to be installed in a Typical installation by using the Feature Properties page.

9. Shortcuts Dialog

This dialog prompts the user to select where he wants to create shortcuts. Four options are available:

  • Desktop
  • Start Menu
  • Quick Launch
  • StartUp Folder

ImportantThese shortcuts must be created in the Files and Folders page in order to be installed. This dialog doesn't create the shortcuts automatically, it simply conditions their creation.

In the bottom pane you can choose what options will be displayed on the dialog during installation as well as their default state.

NoteThis dialog is not available in a "Simple" project.

10. SQL Connection Dialog

This dialog can be useful if the application you are installing depends on a certain database content and configuration. The fields contained by this dialog are:

  • ODBC Resource - In this field you can specify the driver used for the database connection. This driver must be defined in the “SQL Scripts” page, under “Server” pane. The value from this field is saved in ODBC_RES_PROP property.
  • Server - this string represents the server IP address or name. It is saved in SERVER_PROP property.
  • Port - this integer represents the communication port. It is saved in PORT_PROP property.
  • Database - this string represents the database name on which the queries will be performed. It is saved in DATABASE_PROP property.
  • Username - this string represents the username needed to connect to the SQL server. It is saved in USERNAME_PROP property.
  • Password - this string represents the password needed to connect to the SQL server. It is saved in PASSWORD_PROP property.

NoteThis dialog is not available in a "Simple" project.

11. Start Menu Shortcuts Dialog

This dialog allows you to choose the shortcut group from Start Menu in which your program's shortcuts will be installed.

NoteThis dialog is not available in a "Simple" project.

12. Upgrade Dialog

Allows the user to choose whether to automatically remove older versions of the product or to allow side by side installs. This dialog is to be used together with the “Allow side by side installs of different versions of the product” option from the "Install Parameters" page. Also this dialog should be placed after the “Select Location” dialog.

TipTo add a Serial Number Product Registration dialog, go to “Product Information”, select “Licensing” and enable “Use Serial Validation”. For more information, please see Package Serial Validation Page.

NoteThis dialog is not available in a "Simple" project.

Maintenance

The dialogs defined here will appear only during the maintenance process.

Maintenance Welcome Dialog

The first dialog displayed during maintenance. It is used to inform the user about the application on which the maintenance operations will be performed.

Modify, Repair or Remove Dialog

In this dialog, three operations are possible :

  • Modify - Selecting this option will jump to the Customize Dialog.
  • Repair - Selecting this option will reinstall the application, maintaining all the current settings.
  • Remove - This option, if selected, will lead to the application's uninstall process.

Customize Dialog

This dialog appears only if a "Modify" operation was selected in the "Modify, Repair or Remove" dialog. In this dialog, you can select to add or remove features from the application.
In the bottom left part of the dialog, the [ Disk Usage ] button will open the Disk Space Requirements Dialog. This dialog is useful in determining the amount of space available on disk and needed by the application.

Ready to Install Dialog

Allows the user to proceed with the maintenance operation.

Installation Progress Dialog

The dialog containing the progress bar that shows the evolution.

Installation Complete Dialog

The dialog displayed at the end of maintenance.

You can add four more dialogs to this group:

1. File Associations Dialog (ExtRegDlg)

The dialog asks the user to confirm the file associations' creation. The available options allow the user to create all or none of the file associations.

TipIf you want to be able to select which file associations to register, you should use the “FileAssociationsDlg” dialog.

2. File Associations Dialog (FileAssociationsDlg)

This dialog will enable you to select which of the file associations you want to register. In order to use this dialog, go to “File Associations” under “Resources” and select the desired File Extension. In the “Extension Properties” page of the selected element, be sure to enable "Show in FileAssociationsDlg dialog" option.

NoteFor more information, please see File Associations Page.

3. License Agreement Dialog

Displays the license agreement text for your product. In the bottom pane you can select a Rich Text Format file that contains your license agreement. You can localize the License Agreement text.

4. ReadMe Dialog

Displays the ReadMe text for the user. In the bottom pane you can select a Rich Text Format file that contains your readme text. You can localize the ReadMe text.

Patch

The dialogs defined here will appear during a patch installation only.

Patch Welcome Dialog

The first dialog displayed during a patch. It is used to inform the user about the application on which the patch operations will be performed.

Ready to Install Dialog

Allows the user to proceed with the patch operation.

Installation Progress Dialog

The dialog containing the progress bar that shows the evolution.

Installation Complete Dialog

The dialog displayed at the end of the patching operation.

ImportantIn order to modify the layout of these dialogs, all the changes must be made in the upgraded version of the main installation package, prior to creating the patch package from a "Patch Project".

You can add two more dialogs to this group:

1. License Agreement

Displays the license agreement text for your product. In the bottom pane you can select a Rich Text Format file that contains your license agreement. You can localize the License Agreement text.

2. ReadMe Dialog

Displays the ReadMe text for the user. In the bottom pane you can select a Rich Text Format file that contains your readme text. You can localize the ReadMe text.

Resume

The dialogs defined here will appear when the installation process is resumed after a computer reboot.

Resume Welcome Dialog

The first dialog displayed during an installation resume action. It is used to inform the user about the application on which the resume operations will be performed.

Installation Progress Dialog

The dialog containing the progress bar that shows the evolution.

Installation Complete Dialog

The dialog displayed at the end of the installation operation.

Administrative Dialogs

Welcome Dialog

The first dialog displayed during an installation. It is used to inform the user about the application on which the install operations will be performed.

Network Location Dialog

In this dialog you can specify the network location where the server image will be crated.

Destination Browse Dialog

This dialog enables the user to choose the installation location. In this dialog a folder tree control list will appear, for easy usage.

Special Dialogs

The dialogs defined here don't appear directly in any sequence and cannot be removed. They are used to handle special events.

Error Dialog

This dialog is displayed when a non fatal error is detected.

User Exit Dialog

This dialog appears when the user cancels the installation process.

Fatal Error Dialog

This dialog is displayed when a critical error appears, preventing the installation process to continue.

Destination Browse Dialog

This dialog appears when the [ Browse... ] button from "FolderDlg" is pressed, and enables the user to choose the installation folder. In this dialog a folder tree control list will appear, for easy usage.

Customize Dialog

This dialog is displayed when a "Custom" installation type is selected from the "SetupTypeDlg". It will enable the user to select what features to be installed.

Disk Space Requirements Dialog

This dialog displays information about: Disk size, available and required disk space needed by the selected features. The dialog appears by selecting the [ Disk Usage ] button from the "CustomizeDlg" dialog.

Cancel Dialog

This dialog will appear if the user presses the [ Cancel ] button in any dialog during the installation process. A dialog will spawn asking either to continue or cancel the installation procedure.

Files In Use Dialog (FilesInUse)

This dialog appears if a file usage conflict is detected. The list will display all the files that are being used by another application and which will be overwritten by the installation process. There are three possible options:

  • Retry - After the applications that were using the files are closed, the using of this buttons will try to resume the installation process by executing the needed operations on the files.
  • Ignore - Even if the files are being used, the installation procedure can continue. Selecting this button will ensure the installation continues, but skips the operations to be executed on the files.
  • Exit - Selecting this options quits the installation procedure.

Files In Use Dialog (MsiRMFilesInUse)

This dialog appears if a file usage conflict is detected. The list will display all the files that are being used by another application and which will be overwritten by the installation process. In this dialog two options are available

  • Automatically close applications and attempt to restart them after setup is complete
  • Do not close applications (a reboot will be required)

Out of Disk Space Dialog (OutOfDiskDlg)

This dialog appears if the application requires more disk space than is available.

Out of Disk Space Dialog (OutOfRbDiskDlg)

This dialog appears if the application requires more disk space than is available. This dialog also presents the possibility to disable the "rollback" function of the installer.

Wait for Costing Dialog

This dialog is spawned if the user forces the installer to make an operation while it still tries to determinate the needed disk space.

Unused Dialogs

These dialogs have been created in the "Dialogs" page and after a while they were removed.

NoteSome dialogs are mutually exclusive. For example "Setup Type" and "Select Installation Folder" dialogs cannot be selected at the same time. This is because if the "Setup Type" dialog is displayed the user can choose "Custom" and select a destination folder there.

Topics