The SpawnWaitDialog ControlEvent triggers the dialog box specified by the Argument column of the ControlEvent table, if the expression in the Condition column evaluates as FALSE. The dialog box remains up for as long as the conditional expression remains FALSE and is removed as soon as the condition evaluates TRUE.

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.

Published By

This ControlEvent is published by the installer.

Argument

A dialog box in the Dialog table.

Action on Subscribers

None.

Typical Use

The SpawnWaitDialog ControlEvent can be used to wait for any background task the completion of which can be tested using a conditional expression such as the state of a property. For an example of using the SpawnWaitDialog ControlEvent, see the section Authoring a Conditional "Please wait . . ." Message Box.

Send comments about this topic to Microsoft

Build date: 8/13/2009