SdShowFileMods

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdShowFileMods function creates a dialog that displays changes you want to make to a file. These choices are available:

Make changes to the target file.
Make changes to the alternate file, which is a copy of the target file, but incorporates changes.
Do not make any changes. SdShowFileMods does not make changes to a file. You must write those changes into your script using the appropriate file functions.

Syntax

SdShowFileMods ( szTitle, szMsg, szTargetFile, szAltFile, listChanges, nvSelection );

Parameters

SdShowFileMods Parameters

Parameter

Description

szTitle

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

szMsg

Specifies the message to display in the dialog. To display the default instructions for this dialog, pass a null string (“”) in this parameter.

szTargetFile

Specifies the name of the file to modify. This will be displayed with the first radio button.

szAltFile

Specifies an alternate name to give the file if the end user decides to make the changes. This will be displayed with the second radio button. To use the name of file specified in szTargetFile with the extension .bak, pass a null string (“”) in this parameter.

listChanges

Specifies the name of a string list that contains the list of changes to make to the file. This list is placed in a multi-line edit field that allows the end user to select the changes to be implemented.

nvSelection

Returns the ID of the button selected by the end user:

101—“Let Setup modify the <szTargetFile> file.”
102—“Save the required changes to <szAltFile> file.”
103—“Do not make any changes.”

Return Values

SdShowFileMods 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.

See Also