SdSelectFolder

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdSelectFolder function displays folders for selection. SdSelectFolder enables you to offer a default selection. The end user can also enter a new folder name. SdSelectFolder returns only the selected or entered folder name. It cannot create the folder.

Syntax

SdSelectFolder ( szTitle, szMsg, svDefGroup );

Parameters

SdSelectFolder Parameters

Parameter

Description

szTitle

Specifies the title of the dialog. To display the default title (“Select Program Folder”), pass a null string (“”) in this parameter.

szMsg

Specifies the 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.

svDefGroup

Returns the name of the selected folder.

Return Values

SdSelectFolder Return Values

Return Value

Description

NEXT (1)

Indicates that the Next button was clicked.

BACK (12)

Indicates that the Back button was clicked.

Additional Information

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.
If ProgDefGroupType is called before calling SdSelectFolder, the program folders displayed by SdSelectFolder (Common or Personal) depend on the parameter that was passed to ProgDefGroupType.

See Also