In order to design a wizard several properties are available. With them it is possible to customize the appearance and the behaviour of the wizard. Wizard must contain at least one page in order to have some kind of business logic implemented. The number of pages is not limited therefore a wizard can contain as many pages as possible. The appearance and feedback for the whole wizard and individual pages can be defined with just a few properties.
Feedback, Misc and Navigation Properties
| Property | Description |
|---|---|
| CancelQuestion | Defines the text displayed in a dialog box which appears if Cancel command is clicked. |
| CancelTitle | Defines the text displayed in the title of a dialog box which appears if Cancel command is clicked. |
| FinishQuestion | Defines the text displayed in a dialog box which appears if Finish command is clicked. |
| FinishTitle | Defines the text displayed in the title of a dialog box which appears if Finish command is clicked. |
| PageIndex | Defines the currently visible page. First page has number 0, second page has number 1,... |
| Pages | Defines the collection of pages and some of their properties. |
| NavigationVisibility | Defines the manner in which the navigation is displayed on the wizard. If Collapsed is selected, the navigation must be expanded to be visible. If Expanded is selected, the navigation is always visible. If Hidden is selected navigation is never visible. |
Wizard Commands
A wizard has its own navigation which can be accessed from the ribbon. In order to navigate between pages several commands are available.
| Command | Description |
|---|---|
| Next | Moves to the next step or page. If the current step is the last step, the button is disabled. |
| Previous | Moves to the previous step or page. If the current step is the first step, the button is disabled. |
| Cancel | Closes the wizard. If the CancelQuestion and the CancelTitle property are defined, the dialog box is presented to an end user before closing, requesting the confirmation to close the wizard. |
| Finish | Closes the wizard. If the FinishQuestion and the FinishTitle property are defined, the dialog box is presented to an end user before closing, requesting the confirmation to finish the wizard. |
Each page can contain any control which can manipulate with any type of data available on the wizard. For detailed instruction, on how to manage pages, see chapter Pages.
Which data to use for manipulation can be defined with attaching desired MxAdapter component to a wizard.
To attach MxAdapter to a wizard
- Open a wizard by double clicking it in Solution Explorer.
- In Toolbox double click previously created adapter in section Project.Components.
- The adapter is attached to the wizard and its data sources can be used on any control on any page.
Similar any business logic can be used on any page. Business logic is implemented with workflows. In order to be able to access it, similar as MxAdapter, a MxDiagram component must be attached to the wizard.
To attach MxDiagram to a wizard
- Open a wizard by double clicking it in Solution Explorer.
- In Toolbox double click previously created diagram in section Project.Components.
- The diagram is attached to the wizard and all its workflows can be used on any page.
For detailed instruction, on how to implement business logic with workflows, see chapter Workflows on Wizard.