SdStartCopy

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdStartCopy function creates a multi-line edit field displaying the settings and selections made during the installation. The end user can click the Back button on the dialog to return to previous dialogs in order to change settings as required. Call SdStartCopy after retrieving the selections from the user, but before beginning the file transfer process.

Use a string list to collect the information obtained during the installation. You then pass the string list to SdStartCopy in the parameter listData. SdStartCopy displays the list and allows the user to verify that the information is correct before continuing with the file transfer process.

Syntax

SdStartCopy (szTitle, szMsg, listData);

Parameters

SdStartCopy Parameters

Parameter

Description

szTitle

Specifies the title of the dialog. To display the default title (“Start Copying Files”), pass a null string (“”) in this parameter.

szMsg

Specifies the message to display in the static text field above the multi-line edit field. To display the default instructions for this dialog, pass a null string (“”) in this parameter.

listData

Specifies a string list of information retrieved from the end user. SdStartCopy automatically places each element into the multi-line edit field. If listData has not been initialized by a call to ListCreate, the multi-line edit field is hidden and only the static text field is visible.

Return Values

SdStartCopy Return Values

Return Value

Description

NEXT (1)

Indicates that the user selected the Next button.

BACK (12)

Indicates that the user selected the Back button.

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.

See Also