Wizard Dialog Form
The WizardDialogForm is a Form object that provides an abstract implementation of a Wizard on a Form. To use it, simply create a Form that inherits from it. Several properties and methods have been added in the WizardDialogForm implementation.
Controlling the Form Title Bar Text
Title bar text for the WizardDialogForm can be set automatically by the control. The TitleStyle property specifies the method for building the title bar text string. The various styles generally use the TitleBarText property as a base for the title bar text with other text appended to it in one form or another.
Important
It is not recommended that the Text property be set directly since the WizardDialogForm manages that property and may override any value assigned.
If additional title bar text styles need to be implemented, the OnUpdateTitleBarText method can be overridden to provide this extra functionality.
Wizard Event Handlers
Many of the Wizard events have been attached to various methods in the WizardDialogForm control. You can override these methods to handle the wizard events instead of handling the Wizard events in event handlers:
| Method | Description |
|---|---|
| OnBackButtonClick | Occurs when the Back button on the wizard is clicked. |
| OnCancelButtonClick | Occurs when the Cancel button on the wizard is clicked. |
| OnFinishButtonClick | Occurs when the Finish button on the wizard is clicked. |
| OnHelpButtonClick | Occurs when the Help button on the wizard is clicked. |
| OnLayoutButtons | Occurs when control is requested to lay out its child controls. |
| OnNextButtonClick | Occurs when the Next button on the wizard is clicked. |
| OnSelectionChanged | Occurs after a page is selected. |
| OnSelectionChanging | Occurs before a page is selected. |