WizardControl.SelectedPageChanging Event
Enables you to control whether a wizard page can be selected.
Namespace: DevExpress.XtraWizard
Assembly: DevExpress.XtraWizard.v19.1.dll
Declaration
Event Data
The SelectedPageChanging event's data class is WizardPageChangingEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Cancel | Gets or sets whether the operation must be canceled. |
Direction | Gets a value that indicates in which direction a user navigates between pages. Inherited from WizardPageChangedEventArgs. |
Page | Gets or sets the current wizard page. |
PrevPage | Gets the previously active wizard page. Inherited from WizardPageChangedEventArgs. |
Remarks
The SelectedPageChanging event is raised when a new page is about to be selected. This occurs when an end-user clicks the Next or Back button, or the page is selected in code.
Within the SelectedPageChanging event handler you can do the following:
- cancel the operation by setting the WizardPageChangingEventArgs.Cancel property to true;
- initialize settings of the newly selected wizard page, which is returned by the WizardPageChangingEventArgs.Page property;
- implement custom navigation (plot-branched navigation). Use the WizardPageChangingEventArgs.Page property to select the required wizard page. The previously selected page is returned by the WizardPageChangedEventArgs.PrevPage property. To obtain the direction in which a user navigates between wizard pages, use the Direction property.
To learn more, see Page Events.
private void wizardControl1_SelectedPageChanging(object sender,
DevExpress.XtraWizard.WizardPageChangingEventArgs e) {
if(e.Page == wpLongText)
e.Page.AllowNext = ceLongText.Checked;
if(e.PrevPage == wpQuestion && e.Direction == Direction.Forward)
if(ceYesAnswer.Checked) e.Page = wpProgress;
if(e.PrevPage == wpProgress && e.Direction == Direction.Backward)
e.Page = wpQuestion;
}
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SelectedPageChanging event.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.