Reset ControlEvent

[This is preliminary documentation and subject to change.]

The dialog is reset. In other words all the controls on the dialog are called to undo the property changes they have performed. It should reset all the property values to what they were when the dialog was created.

There is one case that is not handled properly. If there are at least two controls on the same dialog linked indirectly to the same property and at least one of them started with some other property originally, this property value is sometimes reset to its second value. Since this case is very esoteric, it is not worth the special code to handle it.

Published By

Handler.

Argument

None.

Action on Subscribers

None.

Action by Publisher When Subscriber Activated

All the controls on the dialog are called to restore the original values of their properties.

Typical Use

A PushButton control on a modal dialog is tied to this event to allow resetting all the values on the dialog, canceling all the changes performed on the page.