Dialog Editor Page

Install Sequence

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

• First Time Install: This section contains the install dialogs that will be displayed when the package is installed for the first time or upgrades another package.
• Maintenance: This sequence of dialogs is displayed when the installer is launched in repair, modify or uninstall mode.
• Patch: This sequence of dialogs belong to a patch package(MSP). They will be displayed when the patch is applied.
• Resume: This sequence of dialogs is displayed when the installation process is resumed after a computer reboot.
• Special Dialogs: These dialogs don't appear directly in any sequence and cannot be removed.
• Unused Dialogs: These dialogs have been created in the "Dialogs" page and after a while they were removed.

Testing the installation User Interface

Use the [ Test Installation UI ] toolbar button or the “Test Installation UI” context menu item in the "Dialogs" page. This will create a temporary package in the Temp folder and run it without performing an actual installation. Since the package is not installed on your machine, only the installation UI sequence can be tested.

Testing the maintenance User Interface

Use the [ Test Maintenance UI ] toolbar button or the “Test Maintenance UI” context menu item in the "Dialogs" page. This will create a temporary package in the Temp folder and run it without performing an actual installation. Your product is temporarily registered with Windows Installer so the maintenance UI sequence can be tested..

Creating a new dialog

Use the [ New Dialog ] toolbar button, the “New Dialog” context menu item or press the Insert key while the “Install Sequence” panel is focused. This option is not always enabled as you can not add a new dialog anywhere in the sequence.

Adding a dialog

Use the Add Dialog toolbar button, the “Add Dialog...” context menu item or press the + key while an existing dialog is selected. The newly created dialog will be inserted below the previously selected dialog. This option is enabled only if there are more available dialogs. The “Add Dialog” dialog box will prompt you to select an available dialog.

Creating a new dialog in sequence

Use the “New Dialog In Sequence” context menu item. This option creates a new dialog and schedules it to run in Install UI Sequence.

Adding a dialog in sequence

Use the “Add Dialog In Sequence” context menu item. The Add Dialog box will prompt you to select an available dialog. Only dialogs from project can be added in sequence.

Exporting a dialog to the repository

Select the dialog you want to export and use the “Move To Repository” context menu option.

Removing a dialog

Use the [ Delete ] toolbar button, the “Delete” tree context menu item or press the Delete key while a dialog is selected.

Moving a dialog between sections

Drag and drop the dialog to the new section.

Sharing a dialog

Drag and drop the dialog to a new section, while the Shift key is pressed. The dialog will be present under both sections.

Show a dialog conditionally

To condition a dialog's appearance use the “Show only if...” tree context menu item. During installation, the dialog will be displayed only if the specified condition is met.

Edit or remove a condition

Once a display condition is set for a dialog it cannot be edited. In order to change the condition you will have to drag & drop the conditioned dialog above the previous dialog from the chain and manually delete the DialogName_Cond entry. Once this is done, re-use the "Show only if..." context menu option and select the new condition.

For example, if you conditioned the FolderDlg dialog: drag & dropFolderDlg dialog over WelcomeDlg dialog and delete the FolderDlg_Cond entry.

Editor

The Editor allows you to modify the currently selected dialog. You can add or remove controls, change the banner and bitmap, change the displayed strings' text style etc.

Control

In the Events Editor pane you can specify events that will be associated with the controls. If the pane is not visible use the “Events” context menu item or press the Ctrl + Shift + Enter keys while the focus is on a control to display it.

Properties

In the Properties pane, all the selected dialog's properties of the selected dialog or control are displayed , grouped in categories. You have the possibility to modify some of them. If the pane is not visible use “Properties” context menu item or press the Ctrl + Enter keys while the focus is on a dialog or control, to display it.