WaitOnDialog

InstallShield 2014 ยป InstallScript Language Reference

The WaitOnDialog function displays a custom dialog. You can write your script to handle different responses from the user based on the return value from this function.

Syntax

WaitOnDialog ( szDlgName );

Parameters

WaitOnDialog Parameters

Parameter

Description

szDlgName

Specifies the ID of the dialog to display.

Return Values

WaitOnDialog Return Values

Return Value

Description

dialog control ID

The ID of the dialog control that received the WM_COMMAND message.

IDCANCEL (2)

This message is received as a signal that the dialog is about to close.

DLG_ERR (-1)

This message is received if any errors occurred.

DLG_INIT (-100)

This message is received immediately before the dialog is displayed.

Additional Information

To enable end users to cancel the installation by clicking the close button in the upper-right corner of the InstallScript dialog, the dialog must have a button control whose Control Identifier property is set to 2. For more information, see Using InstallScript to Implement Custom Dialogs.

See Also