InstallerContactSite Map

This page allows you to customize the existing install dialogs or to create new custom dialogs.

The Dialog Editor is composed of four sections:

  1. Install Sequence
  2. Editor
  3. Control
  4. Properties

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

Test Installation UIUse 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 sequence can be tested.

This option is available only in Enterprise projects.

Creating a new dialog

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

Adding a dialog

Add DialogUse the [ Add Dialog ] toolbar button, the “Add Dialog” context menu item, or press the + key while the focus is on the “Install Sequence” panel. 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 dialog box will prompt you to select an available dialog. Only dialogs from project can be added in sequence.

NoteDialogs displayed by the dialog sequence are shown in bold in the left side tree. Also, dialogs triggered by control events have a lightning symbol on their icon.

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

RemoveUse the [ Delete ] toolbar button, the “Delete” tree context menu item or press the Delete key while the focus is on the “Install Sequence” panel.

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.

ImportantThe dialogs order in each section represents the order in which the dialogs will be displayed when the installer runs.

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.

NoteCategories and properties differ from one control to another.

Topics