SdShowAnyDialog

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdShowAnyDialog function displays a custom or modified dialog. This function is recommended for advanced users only.

Syntax

SdShowAnyDialog ( szTitle, szID, nID, nReserved );

Parameters

SdShowAnyDialog Parameters

Parameter

Description

szTitle

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

szID

Specifies the string identifier that identifies the dialog. If this parameter contains a null string (“”), SdShowAnyDialog uses the value in nID.

nID

Specifies the numeric value that identifies the dialog. If you entered a value in szID, this parameter is ignored.

nReserved

Pass zero in this parameter. No other value is allowed.

Return Values

SdShowAnyDialog 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.
In order to use the SdShowAnyDialog function, you must know the ID of either the modified dialog in _isres.dll or the custom dialog in _isuser.dll that you want to display.
If the dialog has only static controls, you do not need to modify the SdShowAnyDialog script file. However, if your dialog has any other controls, you must modify the Sdsadlg.rul file—located in the Script\Isrt\Src folder of your InstallShield program files folder—in order to process the feedback from the user.

See Also