This article will help you give your application a common wizard interface. One of the main reasons wizards were invented was to make common tasks easier to work with.
The idea for my wizard came soon after I realized I was reproducing code to do the same thing again and again! As working with database applications is my main job, the need for wizard based procedures kept arising more and more. I felt the need to create a common wizard interface to suit my needs.
Just drop the
WizardTemplate control on a form, and you are ready to go.
- Add the control to the toolbox (GNWizardFrameWork.dll).
- Drop the
WizardTemplate on a WinForm.
- Add the pages
- You are done!
Points of interest
The wizard component is written in VB.NET and inherits from
UserControl. Attached to the wizard is a
Wizards usually have two different page layouts, one for exterior pages (the main/welcome page), and one for interior pages (the individual steps within the first and last pages).
Exterior pages usually have a sidebar graphic with a boxed logo. The GNWizardFramework doesn't support this; instead, I have made the exterior page as a blank canvas so the developer can set the complete layout, and not be limited to having a sidebar they might not want.
The interior pages are pretty much the same as the exterior pages except for a few minor alterations. Firstly, as exterior pages fill the whole wizard except for the button bar based at the bottom of the wizard, the interior pages have a header panel, and the working panel locations is compensated by a header.
How the code is brought together
The wizard consists of three classes and two controls:
<TD width=235 bgColor=#fbedbb>Class/Control
<TD width=331 bgColor=#fbedbb>Description
|Designer for the Wizard template|
|Wizard page item|
|Holds all the |
WizardPage details, and handles all events passed by a
|Simple 3D line control|
All pages (interior and exterior) have their own button handlers. Buttons can be accessed by the page you want to change or set:
WelcomePage.HasNextButton = True
WelcomePage.HasPreviousButton = False
WelcomePage.HasFinishButton = False
- Easy to use: Simple design-time interface.
- GUI: An easy to use GUI, what you see at design-time is what you see at runtime.
- PC Support: Works under (tested so far) Win95/98, WinXP, Win2000, and Win2003 Server
Not much here to learn from, but hopefully the library will be of some use. As this is my first article, please be lenient. I hope all of you at least enjoyed reading the article, and maybe you'll find the framework useful.
The GNWizardFramework library is copyright 2005-2006 to Gary Noble, but its source code and the binaries are free for commercial and non commercial use.
Only vote for this article if you like the library.
- 1.01 (21-Dec-2006)
- Updated the 'Previous Button' disabled issue pointed out by Bill Reinhold (Thanks Bill).
- Updated the 'Toolbox bitmap' - Toolbox bitmaps are now handled properly.
- 1.0 (21-Mar-2006) - Initial release.