CustomSetup Dialog Options

InstallShield 2015

Project: This information applies to the following project types:

Basic MSI
MSI Database
Transform

The CustomSetup dialog has a sophisticated end-user interface that is tightly integrated with information about the target system, the features in your installation, and Windows Installer installation options. It provides the end user with the most control over the installation.

Many of the options and information it offers are determined by the feature properties that you set in your setup design, as described below.

Advertisement Option

Feature advertisement enables files to be installed on demand after the installation has initially run. In the CustomSetup dialog, when end users click a feature, they can specify that they want it installed later by selecting the Will be installed when required option.

However, that default option is present only if you select Allow Advertise or Favor Advertise for the feature’s Advertised setting. To prevent Windows Installer from displaying the option to advertise the feature, select Disallow Advertise for this setting.

Hiding Features

When you set a feature’s Display setting to Not Visible, the end user cannot see the feature or its subfeatures in the CustomSetup dialog and therefore cannot change any of its installation options.

Displaying All Subfeatures

The feature’s Display setting also governs whether its subfeatures are expanded when the dialog first appears with the following options:

Options for the Display Setting of a Feature

Option

Description

Visible and Collapsed

The feature is displayed in the CustomSetup dialog with its subfeatures collapsed by default.

Visible and Expanded

The feature is displayed in the CustomSetup dialog with its subfeatures expanded by default.

Setting Default Destination Folders for Features

An end user can view and edit the folder to which a feature will be installed by selecting the feature in the CustomSetup dialog and clicking the Details button. The feature’s Destination setting is the default value that appears, and it is reassigned to a new value if the end user enters or browses to a new path in the resulting Feature Details dialog.

For a complete discussion of the factors that affect where a feature is installed, see Setting a Feature’s Destination.

Naming Features

Specify a different name to appear in the CustomSetup dialog by setting its Display Name.

Displaying Feature Descriptions

The description that is shown at the bottom of the CustomSetup dialog when you select a feature is taken from its Description setting.

Changing the Feature Order

You can change the order in which the features appear to the end user in the CustomSetup dialog. The order in which features are displayed is dictated by the order in the Setup Design view. For more information, see Reordering Features.

Requiring Features To Be Installed

If you set a feature’s Required setting to Yes, the end user does not see the Will not be available option, meaning that the feature must be installed.

See Also