InstallShield 2016 » InstallScript Language Reference
Project • This information applies to the following project types:
| • | InstallScript |
| • | InstallScript MSI |
The SdAskDestPath function creates a dialog that allows the end user to select an alternate destination path. When you click the Change button in that dialog, the SelectDir function is called to open a second dialog that enables the end user either to select an existing folder or to enter a new folder name.
Syntax
SdAskDestPath2 ( szTitle, szMsg, svDir );
Parameters
|
Parameter |
Description |
|
szTitle |
Specifies the title of the dialog. To display the default title ("Choose Destination Location"), pass a null string ("") in this parameter. |
|
szMsg |
Specifies the text to display in the dialog. The text is considered a static control. Use the %P place holder in your message string to insert the product name (if any) that has been specified by a previous call to SdProductName. To display the default instructions for this dialog, pass a null string (""). |
|
svDir |
Specifies the name of the directory to be selected by default. Returns the name of the directory selected by the end user. |
Return Values
|
Return Value |
Description |
|
NEXT |
Indicates that the user selected the Next button. |
|
BACK |
Indicates that the user selected the Back button. |
|
< ISERR_SUCCESS |
Indicates that the dialog could not be displayed. |
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 the end user specifies an incomplete, invalid, or write-protected path in the second dialog, an error message is displayed. If you want the end user to be able to select folders that are not writable, call the AskPath function instead. |
| • | Installations that run in silent mode should create the new folder if it does not exist before calling SdAskDestPath2. This ensures that the confirmation dialog is not displayed. Without this step, two response files are required to handle the two possible conditions. |
See Also
InstallShield 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |