The dialog box is reset. In other words, all the controls on the dialog box are called to undo the property changes they have performed. This event resets all the property values to what they were when the dialog box was created.

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.

There is a case, which should occur rarely in practice, that is not handled properly by this ControlEvent. If there are two or more controls on the same dialog box linked indirectly to the same property and at least one of them started having some other property, then this property value will sometimes be reset to its second value.

Published By

This ControlEvent is published by the installer.

Argument

None.

Action on Subscribers

None.

Typical Use

A PushButton control on a modal dialog box is used to reset all the values on the dialog box and to cancel all the changes on the page.

Send comments about this topic to Microsoft

Build date: 8/13/2009