Magic WizardControl / WizardDialog

• Download source files - 146 Kb
• Download Magic Library - 820 Kb

The Standard Controls

The .NET Framework contains a wide range of user interface controls, but they offer only a basic look and feel. Today's user expects a richer experience that you just cannot build with the out-of-the-box controls. The Magic Library (of which the WizardControl/WizardDialog are part of) aims to solve this by providing a set of user interface elements that add the sophistication expected from modern Windows applications.

Downloads

The first download WizardControl/WizardDialog Sample contains a example application that uses shows the MenuControl from the Magic Library. This allows you to experiment and test out the feature. The actual source code is inside the separate second download. At nearly 1MB in size, I thought people would prefer to download the sample before deciding if they want to install the entire source code project!

Description

The WizardControl should be used when you need to guide the user through a series of steps. Simple examples include creating an installation program or allowing the creation a new items by answering a series of questions. In most situations you will want to use a modal dialog to host an instance of the WizardControl. Rather than create your own Form the library already includes a Form called WizardDialog. Download the Magic Library and see the relevant article for more details on how to use the WizardDialog.

Profiles

The Profile property of the control is used to configure the appearance and operation of the wizard. The three available options are: -

Install

As the name implies, this profile should be used to create a series of steps that perform an installation process. In this scenario the ordering of the wizard pages is very important and the control will make assumptions about the purpose of pages.

The last page is always used to report the end result of the install attempt. Therefore the last page will by default only display the Close button as that is the only possible action. It makes no difference if your page is reporting a success or failure result the only possible action is to close down the installation process.

The second to last page is used to perform the actual install action and so the only available button will be Cancel. Once the install attempt has begun it makes no sense allowing the user to move Back to previous pages or to move past the current page. When the install action has completed you should manually move the wizard onto the last page using the SelectedIndex property in order to report the outcome.

All the preceding pages are assumed to be used in gathering information from the user and so the Next and Back buttons will be shown depending on the appropriate availability. The Cancel button is always shown so that the user can exit the wizard at this time.

Configure

Use this profile to gather information needed to perform a custom action that is conducted once the user clicks the Finish button. A good example would be adding a new item to your project. Every page has the Cancel, Next, Back and Finish buttons displayed with the Next and Back only enabled when appropriate for the selected page. The user can use the Finish button at any time to accept all the default values and have the custom action performed immediately. Alternatively they can move through the series of pages and customize the values.

If you need to enfore some mandatory fields before the Finish button is enabled then change the EnableFinishButton property to Status.No when the control is created. Once you notice that all mandatory fields have been supplied change the property to Status.Yes to allow the user to select the Finish button.

Controller

Unlike the previous profiles this one does not show the heading portion at the top of the control and does show the individual tab headers. This allows the user to click between pages in a random order to select and modify the contents as required. There are only two buttons presented by default, Update and Cancel. Use this profile when the user needs to see and modify a group of related settings. They can use the Update button to apply the changes in an appropriate way or use the Cancel button to discard any changes made.

Customization

If none of the above profiles does exactly what you need then you have scope to customize the the profile that comes closest. Each button has a set of three properties used to control when the button is displayed, when the button is enabled and the text shown on the button. For example, the properties for the Update button are called ShowUpdateButton, EnableUpdateButton and ButtonUpdateText respectively.

Imagine you are using the Controller profile to present a dialog box of project settings to the user. The user can move between pages and change the settings as desired. When they press the Update button you apply those changes immediately. However, you might prefer to have the button called Apply rather than Update. Simply set the ButtonUpdateText property to the required string to change the button text. But you must remember that the event generated when the button is pressed is still called UpdateClick .

In another situation you might have a Cofigure profile used to setup a new item within your project. But you do not want the Cancel button availale to the user, instead you want to force your user to move through the whole process and use the Finish button. In this case you would set the ShowFinishButton property to Status.No which prevents the button from being displayed on any page. If you need a button displayed all the time then assign the Status.Yes value to the appropriate button show property. By default each buttons show and enable properties has the Status.Default value that indicates the control should calculate the correct state depending on the currently seleted Profile and page index.

Often you will want to change the displayed/enabled state of buttons on a per-page basis. In this case you need to hook into the WizardPageEnter and WizardPageLeaveevents and set the appropriate values depending on the page selected.

Default Buttons

By default the AssignDefaultButton property is defined as False and so the control will not make any attempt to assign a default button for the Form the control is contained inside. If you decide to enable this property the following logic is used to determine which button should become the default.

Install Profile

On the last page the only button displayed by default is Close and so this will be used as the default. On the second to last page the only button is Cancel which is therefore the default. All other pages assign the Next button as the default.

Configure Profile

The last page will use the Finish button as the default and all other pages the Next button.

Controller Profile

The Update button is always designated the default in this profile.

Revision History

30 Sept 2002 - Initial Revision

You must Sign In to use this message board.

FAQ    Noise Tolerance Very HighHighMediumLowVery Low   Layout Expand Posts & RepliesThread ViewNo JavascriptNo JS + Preview   Per page 102550

Msgs 1 to 6 of 6 (Total in Forum: 6) (Refresh) FirstPrevNext

Docking Bug CastorTiu 22:09 30 May '06   The library doesn't work properly for docking on a MDI form. If you minimize it and restore the main Windows having a docking panel in the MDIForm, it get reduced to a few pixels width or height. Steps to reproduce. 1) Create a Form (Form1) 2) Create a Form (Form2) 3) Create Docking Windows and put something in it 4) Run Form1 5) From Form1 create an instance to Form2, assign MDIParent to Form1 and show it. 6) Minimize 7) Restore There you are... Does someone knows how to fix this? Thanks, Gustavo. Sign In·View Thread·PermaLink A few bugs? Detron 3:36 4 Jun '03   This is what I get from Visual Studio .NET 2002: 1) Setting the property TitleMode = Steps in my WizardDialog renders nice in Design mode, but when I save the file in subject and reopens it, VS.NET outputs this error message: "C:\Documents and Settings\MB014\Desktop\TheMissingLink\forWizard.cs(150): The variable 'TitleModes' is either undeclared or was never assigned." 2) Setting the property ShowFinishButton = No in my WizardDialog renders nice in Design mode, but when I save the wizard file and reopens it, VS.NET outputs this error message: "C:\Documents and Settings\MB014\Desktop\TheMissingLink\forWizard.cs(64): The variable 'Status' is either undeclared or was never assigned." And as a conclusion; those two settings in subject are of course "forgotten" on reopen - thats the problem! Anyone experienced this oddd behaviour and/or have a solution to this? P.S: Either way... Magic Library rules bigtime - thanks Phil! Sign In·View Thread·PermaLink Problem using wizardControl vbnetuk 9:07 17 May '03   Hi there, Can somebody help me here? Trying to use the wizardControl 02 option button at the start on configure profile =============================================== if you press the first one it should direct you to one page if you press the 2nd one than you should go to a different page Tried and tried to code the onNextClick and ONBackClick page it doesnt work correctly I always go to the wrong page! With WizardControl If optGenDAL.Checked = True Then If .SelectedIndex = 0 Then '//if wizStart '//goto wizdalSettings .SelectedIndex = 1 ElseIf .SelectedIndex = 1 Then '//if wizdalsettings '//goto wizDalSPS .SelectedIndex = 2 ElseIf .SelectedIndex = 2 Then '//if wizdalsps '//go to WizdalFinish .SelectedIndex = 3 End If End If If OptClsBuilder.Checked = True Then If .SelectedIndex = 0 Then '//if wizStart '//go to wizclssettings .SelectedIndex = 4 ElseIf .SelectedIndex = 4 Then '//wizclssettings '//goto wiztables .SelectedIndex = 5 ElseIf .SelectedIndex = 5 Then '//if wiztables '//go to wizclsfinish .SelectedIndex = 6 End If End If End With End Sub CAN SOMEBODY EXPLAIN WHY IT DOESNT WORK! I coded something similar on the OnBackClick event Thanks A lot Gabriel vbnetuk@yahoo.co.uk Sign In·View Thread·PermaLink Magic 1.7.3 Released Phil Wright 11:15 2 Mar '03   Version 1.7.3 of the Magic Library is now available from... http://www.dotnetmagic.com Includes numerous bug fixes to the Menus, TabControl and Docking functions. For those new to the library it includes VS.NET style controls for... Menus, TabControl, Tabbed MDI, Docking Windows, Wizard Control/Dialog. All the source code is included in the download that can be used free of charge or royalties in commerical as well as private applications. Phil Wright phil.wright@dotnetmagic.com Sign In·View Thread·PermaLink Re: Magic 1.7.3 Released Chris Maunder 11:12 17 May '03   Hey Phil - I assume you have no problem with me updating this article with the latest version from your site? cheers, Chris Maunder Sign In·View Thread·PermaLink Re: Magic 1.7.3 Released Phil Wright 1:28 18 May '03   Yes thats fine. You might also want to upthe the Magic Docking and Magic Menus articles at the same time !! It might be easir to have the code download link go either directly to my website for the source forge URL so it downloads the latest version all the time. Phil Wright phil.wright@dotnetmagic.com Sign In·View Thread·PermaLink 2.50/5 (6 votes)

Last Visit: 6:46 23 Nov '09     Last Update: 6:46 23 Nov '09 1