This page describes the optional install dialogs. Their presence is not mandatory in the installation wizard. These dialogs can be added to the chain of dialogs using the Add Dialog.
FolderDlg
Allows the user to select the folder where the package will be installed.
LicenseAgreementDlg
Displays the license agreement text for your product. You can select the Rich Text Format file that contains your license agreement in the “RTF File” field of the Properties pane. This field is available when the “Scrollable Edit” control is selected on the dialog.
ReadMeDlg
Displays the ReadMe text for the user. You can select the Rich Text Format file that contains your license agreement in the “File Path” field of the Properties pane. This field is available when the “Scrollable Edit” control is selected on the dialog.
UserRegistrationDlg
Allows the user to enter the product's serial number. You can set the options for the serial number validation in the Package Serial Validation Page.
SetupTypeDlg
Allows the user to select the installation's type. This dialog and the "FolderDlg" 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.
You can set a feature to be installed in a Typical
installation by using the Feature
Properties page.
PrerequisitesDlg
This dialog uses the Prerequisites Selector to displays the state of feature-based prerequisites and allows the user to choose which one to be installed.
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 (the user cannot choose to create only some of the
file associations).
FileAssociationsDlg
When added, this dialog is automatically populated with the extensions which use the Show in extension list option in Extension Properties pane.
If you want to remove a checkbox from this dialog you can disable
the "Show in extension list" option for the associated
extension.
UpgradeDlg
Allows the user to choose whether to automatically remove older product versions 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.
This dialog should be placed after the “Select
Location” dialog.
ShortcutsDlg
This dialog prompts the user to select where he wants to create shortcuts. Four options are available:
- Desktop location, corresponds with Desktop folder from Files and Folders Page.
- Start Menu location, corresponds with Application Shortcut Folder from Files and Folders Page.
- StartUp Folder location, corresponds with Start Menu\Startup folder from Files and Folders Page.
- Quick Launch location, corresponds with Application Data\Microsoft\Internet Explorer\Quick Launch folder from Files and Folders Page.
In the “Shortcuts Actions” tab from the "Control" view you can choose what shortcuts will be displayed on the dialog during installation as well as their default state.
These 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. Optionally, you can use the
Shortcut Wizard to assist you in the creation of
all the presented shortcuts.
SQLConnectionDlg
Use this dialog to collect information about an SQL connection. It can be used complementary with the SQL Scripts feature.
This dialogs defines and uses the following global properties:
| Property name | Description |
| ODBC_RES_PROP | Name of the driver used to connect to the SQL Server |
| SERVER_PROP | Name of the SQL Server |
| PORT_PROP | Port number used to connect to the SQL Server |
| DATABASE_PROP | Name of the database used to query SQL scripts |
| USERNAME_PROP | Name of the user used to connect to the SQL Server |
| PASSWORD_PROP | Password associated with the username used to connect to the SQL Server |
These properties can be easily used to configure a SQL connection.
For more information please, visit the How To article.
StartMenuShortcutsDlg
This dialog allows you to choose the shortcut group from Start Menu in which your program's shortcuts will be installed.
NewDialog
This is a blank dialog that you can customize as want and can serve any purpose.
Some dialogs are mutually exclusive. For example "SetupTypeDlg"
and "FolderDlg" dialogs can't be selected at the same time. This is
because if the "SetupTypeDlg" dialog is displayed the user can choose
"Custom" and select a destination folder there.