Getting Started with WPF WizardControl

18 Nov 20184 minutes to read

This section explains how to get started with the WizardControl.

Highlighting features

The following are some of the key features of WizardControl:

  • WizardControl uses WizardPage objects to organize content into multiple pages.
  • Built-in navigation buttons such as Back, Next, Finish, Cancel, and Help enable navigation between wizard pages.
  • Supports customization of the appearance of both WizardControl and WizardPage.

Assembly deployment

Refer to the Control Dependencies section for the list of assemblies and NuGet packages required to use the WizardControl in a WPF application.

NuGet package: Syncfusion.Tools.Wpf

For more information about installing NuGet packages in a WPF application, refer to the following article:
How to install nuget packages

Creating Application with WizardControl

In this walkthrough, you will create a WPF application that uses the WizardControl.

  1. Creating project
  2. Adding control via designer
  3. Adding control manually in XAML
  4. Adding control manually in C#
  5. Adding multiple pages

Creating project

Follow these steps to create a WPF project in Visual Studio and add the WizardControl to it.

Adding control via designer

The WizardControl control can be added to the application by dragging it from the Toolbox and dropping it onto the designer surface. The required assembly references are added automatically.

Adding WPF Wizard Control via designer

Adding control manually in XAML

To add the WizardControl control manually in XAML, follow these steps:

  1. Add the required assembly references to the project:

    • Syncfusion.Shared.WPF
    • Syncfusion.Tools.WPF

  2. Import the Syncfusion WPF schema http://schemas.syncfusion.com/wpf in the XAML page.

  3. Add the WizardControl to the XAML page.

    <Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WizardControl"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf" x:Class="WizardControl.MainWindow"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
        <syncfusion:WizardControl Name="wizardControl"/>
    </Grid>
</Window>

Adding control manually in C#

To add the WizardControl control manually in C#, follow these steps:

  1. Add the required assembly references to the project:

    • Syncfusion.Shared.WPF
    • Syncfusion.Tools.WPF

  2. Import the Syncfusion.Windows.Tools.Controls namespace.

  3. Create an instance of WizardControl and add it to the window.

    using System.Windows;
using System.Windows.Controls;
using Syncfusion.Windows.Tools.Controls;
namespace WizardControl
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            WizardControl wizardControl = new WizardControl();
            this.Content = wizardControl;
        }
    }
}

WPF Wizard Control

Adding multiple pages

You can add multiple pages to the WizardControl by using WizardPage objects. The Back, Next, Finish, and Cancel buttons are enabled or disabled automatically based on the currently displayed page.

<syncfusion:WizardControl Name="wizardControl">
    <syncfusion:WizardPage Name="wizardPage1"/>
    <syncfusion:WizardPage Name="wizardPage2"/>
    <syncfusion:WizardPage Name="wizardPage3"/>
</syncfusion:WizardControl>
WizardControl wizardControl = new WizardControl();
WizardPage wizardPage1 = new WizardPage();
WizardPage wizardPage2 = new WizardPage();
WizardPage wizardPage3 = new WizardPage();

wizardControl.Items.Add(wizardPage1);
wizardControl.Items.Add(wizardPage2);
wizardControl.Items.Add(wizardPage3);

Adding multiple pages in WPF Wizard Control

Theme

WizardControl supports a variety of built-in themes. Refer to the following articles to learn how to apply themes to the WizardControl:

Setting theme to WPF Wizard Control