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
© 2009 Microsoft Corporation. All rights reserved.