This event notifies the installer to remove a modal dialog box. In all cases the installer removes the present dialog box.

This event can be published by a PushButton Controlor a SelectionTree control. This event should be authored into the ControlEvent table.

This ControlEvent requires the user interface to be run at the full UI level. This event will not work with a reduced UI or basic UI. For information, see User Interface Levels.

The following table lists the action of the event resulting from different arguments entered into the ControlEvent table.

Argument	Action by the installer
Exit	The wizard sequence is closed and the control returns to the installer with the UserExit value. This argument cannot be used in a dialog box that is a child of another dialog box.
Retry	The wizard sequence is closed and the control returns to the installer with the Suspend value. This argument cannot be used in a dialog box that is a child of another dialog box.
Ignore	The wizard sequence is closed and the control returns to the installer with the Finished value. This argument cannot be used in a dialog box that is a child of another dialog box.
Return	The control returns to the parent of the present dialog box, or if there is no parent, the control returns to the installer with the Success value.

 

Published By

This ControlEvent is published by the installer.

Argument

On regular dialog boxes the Argument column of the ControlEvent table can be "Return", "Exit", "Retry", or "Ignore".

On error dialog boxes the Argument column of the ControlEvent table can be "ErrorOk", "ErrorCancel", "ErrorAbort", "ErrorRetry", "ErrorIgnore", "ErrorYes", or "ErrorNo".

Action on Subscribers

None.

Typical Use

A PushButton control on a modal dialog is tied to this event in the ControlEvent table to close a dialog box.

Send comments about this topic to Microsoft

Build date: 8/13/2009