InstallShield 2016 » InstallScript Language Reference
Project • This information applies to the following project types:
| • | InstallScript |
| • | InstallScript MSI |
The SdSetupType2 function displays a dialog that enables the end user to select one of the two standard setup types: Typical 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.
The dialog also displays a default destination path. A browse button launches a dialog that allows the end user to change the destination path, either by entering a new folder name or by selecting an existing folder from a list. If the end user enters the name of a folder that does not exist, this function automatically creates the specified folder. The fully qualified path of the specified folder is returned in svDir.
Caution • If the end user returns to the SdSetupType2 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 SdSetupType2 function automatically resets the default feature selections for the selected setup type each time it is called.
Syntax
SdSetupType2 ( szTitle, szMsg, svDir, nReserved );
Parameters
|
Parameter |
Description |
|
szTitle |
Specifies the title of the dialog. To display the default title (“Setup Type”), pass a null string (“”) in this parameter. |
|
szMsg |
Specifies a message to display in the dialog. This text is considered a static control. To display the default instructions for this dialog, pass a null string (“”) in this parameter. |
|
svDir |
Specifies a default folder name. Returns the name of the folder selected by the end user. |
|
nReserved |
Reserved for future use. Pass 0 (zero) in this parameter. |
Return Values
|
Return Value |
Description |
|
COMPLETE (304) |
Indicates that the user selected the Complete setup type. |
|
TYPICAL (301) |
Indicates that the user selected the Typical setup type. |
|
CUSTOM (303) |
Indicates that the user selected the Custom setup type. |
|
BACK (12) |
Indicates that the user clicked the Back button. |
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
InstallShield 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |