Skip Navigation LinksActipro Software / Products / .NET Controls / WPF / Wizard / Page Sequencing

Feature Tour:

Page Sequencing

Wizard has many helpful features for setting up the sequence in which pages will be visited.

The simplest way to set up page sequencing is declaratively in XAML. In addition, default page sequencing may be overridden and page changes can be initiated programmatically.

Page Sequence Types

At the root level, Wizard has two modes of default page sequencing:

  • Normal - Normal page sequencing, in which pages are visited in the order in which they appear in the pages collection.

  • Stack - Normal page sequencing occurs when the Next button is pressed. Each page visited is stored in an internal stack. Back button presses move backwards through the stack.

Setting a Page's Next or Previous Page

The WizardPage class has NextPage and PreviousPage properties. These allow you to declaratively override the default page sequencing.

Both properties are of type Object and can accept four types of values:

  • null - By setting a null value (the default) to those properties, you indicate that the default page sequence type (see above) should be used.
  • Page Index - By setting an integer number value to those properties, you indicate that the next or previous page for the page should be the page at the specified numeric index within the parent Wizard's page collection.
  • Page Name - By setting a String value to those properties, you indicate that the next or previous page for the page should be the page with the specified name within the parent Wizard's pages collection.
  • Page Reference - By setting an explicit WizardPage reference to those properties, you indicate that the next or previous page for the page should be the specified page.

Disable Pages to Skip Over Them

Default page sequencing will skip over any WizardPage whose IsEnabled property is set to false.

This makes it easy to "turn off" pages temporarily.

Diagram showing how a disabled page is skipped in default page sequencing