Setup Factory for Windows Installer

Dialogs

This dialog is where you can design the appearance, flow and logic of your installer's user interface (UI).

User Interface

Edit mode:

Choose which edit mode that you want to use. Note that you are editing the same underlying data in either mode, the Advanced mode just allows you a finer level of control and to see more sequences and dialogs.

Simple

In simple edit mode you will view and edit only your primary installation sequence. That is, the sequence of dialogs that appears when the installer is run on a system and has not been installed before. That is, it is not in maintenance, remove, or resume mode. In most cases, this will be the only view that you will need to use. However, you can always switch to Advanced mode for a finer level of control and to see and edit the other sequences.

The dialogs in the primary installation sequence will be show in top-down order according to the list below.

Advanced

In advanced mode you will see a tree view of your dialogs. This view allows you to see and edit every dialog and sequence that will be included with your installer. There are three root items in the tree. InstallUISequence and AdminUISequence are the two main Windows Installer UI sequences that can be edited. The Support Dialogs item contains dialogs that do not directly belong to a sequence but are required by dialogs that are in a sequence.

Below the two UI sequences you will see dialog sequence items as children. Dialog sequences instruct Setup Factory where the sequence should be inserted into the InstallUISequence and AdminUISequence WiX elements and MSI tables, as well as the condition on the sequence. See the Dialog Sequence Properties dialog for more details about dialog sequences.

The dialog sequences in turn contain actual dialogs. By default the dialogs below a sequence will be shown in top-down order, although you can explicitly change the order by editing the events published by the dialogs' controls. However, the first (top-most) dialog in the sequence will always be the dialog that gets displayed, regardless of any other explicit ordering.

Click the Add button to open the Add Dialog dialog and add a new dialog to the sequence or to add a new dialog sequence to either the InstallUISequence or AdminUISequence (Advanced edit mode).

Click the Edit button to open the Dialog Settings dialog if a dialog is selected, or the Dialog Sequence Properties dialog if a dialog sequence is selected (Advanced edit mode).

You can use the arrow keys to move the dialogs up and down in their sequences.

The Advanced button brings up a menu which allows you to change your dialog set. See the Change Dialog Set dialog for details.

Dialog Editor

The dialog editor shows you the currently selected dialog and lets you edit its layout and controls.

Editing the Dialog's Settings

You can edit the settings of the dialog itself by:

- Double-clicking the dialog to open the Dialog Settings dialog.

- Right-click on the dialog and select Edit from the context menu.

Adding a New Control

You can add a new control to your dialog by doing one of the following:

- Press the Insert button and choose a control from the menu.

- Right-click on the dialog itself (not on a control) and choose a control from the Add menu item.

When you choose to add a control the mouse cursor will turn into a cross hairs and you can either click where you want the control in order to create a control of the default size or drag-select the area that you want the control to fill.

Selecting a Control

You can select a control simply by clicking it with the left mouse button. Alternatively, you can select a specific control from the controls combo box to the right of the Insert button.

Editing a Control

To edit the control's settings in a control properties dialog do any one of the following:

- Double-click the mouse on the control.

- Right-click on the control and choose Edit from the context menu.

- Select the control and then press the edit button (to the immediate right of the controls combo box).

Moving a Control

To move a control do any one of the following:

- Drag and drop controls using the left mouse button.

- Open the control's properties dialog, select the Attributes tab and then use the fields in the Position and Size section.

- Select a control and then use the arrow keys on your keyboard to move them one unit at a time.

Removing a Control

To remove a control do any one of the following:

- Select the control and then press the Delete key on your keyboard.

- Right-click on the control and select Remove from the context menu.

- Select the control and press the remove button (to the left of the Language field).

Changing the Current Language

You can use the Language combo box to choose which language that you are currently viewing and editing. The available languages are taken from the ones that you included in the Languages dialog.