Programmatically Controlling Page Sequence

In many cases, you will want to customize the order in which pages display. The Wizard control provides events for doing this.

There are two methods for manually controlling page sequence:

• Page sequencing may be controlled in the wizard-level NextButtonClick and BackButtonClick events of the Wizard control.

• Page sequencing may also be controlled in the page-level NextButtonClick and BackButtonClick events of WizardPage controls.

Example Scenario

As an example, say you have a three-page wizard and there is a checkbox on the first page. If the checkbox is checked, you are on the first page, and you press the Next button, you want the wizard to skip the middle page and go directly to the last page. Likewise, if the checkbox is checked, you are on the last page, and you press the Back button, you want to skip the middle page and go back to the first page. If the checkbox is left unchecked, navigation using the buttons will move through all three pages.

Controlling Page Sequence with the Wizard

To do this, you create event handlers for both the NextButtonClick and BackButtonClick events in the Wizard control.

In the NextButtonClick event handler, you implement this code:

private void wizard_NextButtonClick(object sender, WizardPageCancelEventArgs e) {
	if ((wizard.SelectedIndex == 0) && (checkBox.Checked)) {
		e.Cancel = true;
		wizard.SelectedIndex = 2;
	}
}

In the BackButtonClick event handler, you implement this code:

private void wizard_BackButtonClick(object sender, WizardPageCancelEventArgs e) {
	if ((wizard.SelectedIndex == 2) && (checkBox.Checked)) {
		e.Cancel = true;
		wizard.SelectedIndex = 0;
	}
}

With those two events in place on the wizard, the default navigation of pages is cancelled when the checkbox is checked, and the page selection is then manually updated to skip the middle page.

Controlling Page Sequence with a WizardPage

However, you also could have implemented the NextButtonClick and BackButtonClick events for the WizardPage control.

In the NextButtonClick event handler, you implement this code:

private void firstWizardPage_NextButtonClick(object sender, WizardPageCancelEventArgs e) {
	if (checkBox.Checked) {
		e.Cancel = true;
		wizard.SelectedIndex = 2;
	}
}

In the BackButtonClick event handler, you implement this code:

private void lastWizardPage_BackButtonClick(object sender, WizardPageCancelEventArgs e) {
	if (checkBox.Checked) {
		e.Cancel = true;
		wizard.SelectedIndex = 0;
	}
}

With those two events in place on the wizard, the default navigation of pages is cancelled when the checkbox is checked, and the page selection is then manually updated to skip the middle page.