Contact Support
Event Handling in Windows Forms Wizard
5 Dec 20232 minutes to read
This section comprises the below events:
Wizard control events
The events available for Wizard control and the methods which raises these events are listed in the below tables.
- Back
- Next
- Cancel
- Finish
- Help
- BannerControlLocationChanging
- BeforePageSelect
- BeforeBack
- BeforeFinish
- PreviousPage
- NextPage
BannerControlLocationChanging event
This BannerControlLocationChanging event is discussed in How to Cancel the AutoLayout of the Banner panel controls.
Wizard page events
The events available for the Wizard Page and the methods which raises these events are listed in the below tables.
- BackClick
- NextClick
- CancelClick
- FinishClick
- HelpClick
- PageLoad
- ValidatePage
- RaiseBackClick
- RaiseNextClick
- RaiseCancelClick
- RaiseFinishClick
- RaiseHelpClick
- RaisePageLoad
- RaiseValidatePage
ValidatePage event
WizardControl Pages can be validated using ValidatePage event. In this event, data validation can be performed and traversing to the next page can be canceled, if the validation fails.
If the user does not want to validate a page while moving back (pressing BackButton), then it can be done by setting BackButtonCausesValidation property to false
.
// Handling ValidatePage Event
private void wizardControlPage2_ValidatePage(object sender, System.ComponentModel.CancelEventArgs e)
{
if(this.textBox1.Text == String.Empty)
{
MessageBox.Show("Text cannot be empty.","Data Needed",MessageBoxButtons.OK,MessageBoxIcon.Warning);
e.Cancel = true;
this.textBox1.Focus();
}
else if(this.textBox1.Text != "Next")
{
MessageBox.Show("Correct Value needed.","Incorrect value",MessageBoxButtons.OK,MessageBoxIcon.Warning);
e.Cancel = true;
this.textBox1.Text = "";
this.textBox1.Focus();
}
}
' Handling ValidatePage Event
Private Sub wizardControlPage2_ValidatePage(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles wizardControlPage2.ValidatePage
If Me.textBox1.Text = String.Empty Then
MessageBox.Show("Text cannot be empty.","Data Needed",MessageBoxButtons.OK,MessageBoxIcon.Warning)
e.Cancel = True
Me.textBox1.Focus()
Else If Me.textBox1.Text <> "Next" Then
MessageBox.Show("Correct Value needed.","Incorrect value",MessageBoxButtons.OK,MessageBoxIcon.Warning)
e.Cancel = True
Me.textBox1.Text = ""
Me.textBox1.Focus()
End If
End Sub