SetupType2

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SetupType2 function displays a dialog that enables the end user to select one of the two standard setup types: Complete or Custom. These setup options are displayed with standard description text. If you want to add other setup types or change the displayed setup type names or descriptions, call SdSetupTypeEx instead.

Caution: If an end user returns to the Setup Type dialog after using a feature dialog to select and deselect features associated with the selected setup type, those choices are lost. This occurs because the SetupType2 function automatically resets the default feature selections for the selected setup type each time it is called.

Syntax

SetupType2 ( szTitle, szMsg, szReserved, nType, nReserved );

Parameters

SetupType2 Parameters

Parameter

Description

szTitle

Specifies the title of this dialog. To display the default title Setup Type2, pass a null string ("") in this parameter.

szMsg

Specifies the message you want to display at the top of the dialog. To display the default instructions for this dialog, pass a null string ("") in this parameter.

szReserved

Pass a null string ("") in this parameter. No other value is allowed.

nType

Specifies the default setup type when the dialog is opened. Pass one of the following predefined constants in this parameter:

COMPLETE—Defines the default setup type as Complete.
CUSTOM—Defines the default setup type as Custom.

nReserved

Pass zero in this parameter. No other value is allowed.

Return Values

SetupType2 Return Values

Return Value

Description

COMPLETE (304)

Indicates that the Complete setup type was selected.

CUSTOM (303)

Indicates that the end user selected the Custom setup type.

BACK (12)

Indicates that the end user clicked the Back button.

< ISERR_SUCCESS

Indicates that the dialog could not be displayed.

Additional Information

In an InstallScript project, if you do not display a setup type dialog, your script must do one of the following:
Select a setup type.
Call a feature selection dialog function such as SdFeatureTree.
Directly select features.
To view an example of this or other dialogs for your installation, use the Dialog Sampler. In InstallShield, on the Tools menu, point to InstallScript, then click Standard Dialog Sampler or Skinned Dialog Sampler.

See Also