Class
RadWizard

The RadWizard class provides a user interface control designed to guide users through a structured sequence of steps in a wizard-like fashion. It allows complex processes to be broken down into manageable sections or pages, facilitating smooth navigation and interaction. The class maintains a collection of wizard pages, supports commands for navigating between them, and enables event handling to respond to user actions such as moving to the next or previous page, finishing the wizard, cancelling, or invoking help. This control is beneficial for applications that require users to complete processes that involve multiple steps, ensuring clear guidance and feedback throughout the experience.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadWizard : Control

Inheritance: objectRadWizard

Constructors

RadWizard()

Initializes a new instance of the RadWizard class.

Declaration

cs-api-definition
public RadWizard()

Fields

CanCancelProperty

Identifies the CanCancel dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanCancelProperty

Field Value

DependencyProperty

The identifier for the CanCancel dependency property.

CanCancelPropertyKey

Identifies the CanCancel dependency property.

Declaration

cs-api-definition
public static readonly DependencyPropertyKey CanCancelPropertyKey

Field Value

DependencyPropertyKey

CanFinishProperty

Identifies the CanFinish dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanFinishProperty

Field Value

DependencyProperty

The identifier for the CanFinish dependency property.

CanFinishPropertyKey

Identifies the CanFinish dependency property.

Declaration

cs-api-definition
public static readonly DependencyPropertyKey CanFinishPropertyKey

Field Value

DependencyPropertyKey

CanHelpProperty

Identifies the CanHelp dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanHelpProperty

Field Value

DependencyProperty

The identifier for the CanHelp dependency property.

CanHelpPropertyKey

Identifies the CanHelp dependency property.

Declaration

cs-api-definition
public static readonly DependencyPropertyKey CanHelpPropertyKey

Field Value

DependencyPropertyKey

CanMoveCurrentToNextProperty

Identifies the CanMoveCurrentToNext dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanMoveCurrentToNextProperty

Field Value

DependencyProperty

The identifier for the CanMoveCurrentToNext dependency property.

CanMoveCurrentToNextPropertyKey

Identifies the CanMoveCurrentToNext dependency property.

Declaration

cs-api-definition
public static readonly DependencyPropertyKey CanMoveCurrentToNextPropertyKey

Field Value

DependencyPropertyKey

CanMoveCurrentToPreviousProperty

Identifies the CanMoveCurrentToPrevious dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanMoveCurrentToPreviousProperty

Field Value

DependencyProperty

The identifier for the CanMoveCurrentToPrevious dependency property.

CanMoveCurrentToPreviousPropertyKey

Identifies the CanMoveCurrentToPrevious dependency property.

Declaration

cs-api-definition
public static readonly DependencyPropertyKey CanMoveCurrentToPreviousPropertyKey

Field Value

DependencyPropertyKey

CommandProviderProperty

Represents the CommandProvider DependencyProperty.

Declaration

cs-api-definition
public static readonly DependencyProperty CommandProviderProperty

Field Value

DependencyProperty

DirectionProperty

Identifies the Direction DependencyProperty.

Declaration

cs-api-definition
public static readonly DependencyProperty DirectionProperty

Field Value

DependencyProperty

IsContentPreservedProperty

Represents the IsContentPreserved DependencyProperty.

Declaration

cs-api-definition
public static readonly DependencyProperty IsContentPreservedProperty

Field Value

DependencyProperty

SelectedPageIndexProperty

Represents the SelectedPageIndex DependencyProperty.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedPageIndexProperty

Field Value

DependencyProperty

SelectedPageProperty

Represents the SelectedPage DependencyProperty.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedPageProperty

Field Value

DependencyProperty

Properties

CanCancel

Gets a value that indicates whether the user can cancel the operation.

Declaration

cs-api-definition
public bool CanCancel { get; }

Property Value

bool

true if the user can cancel the operation; otherwise, false.

CanFinish

Gets a value that indicates whether the user can finish the operation.

Declaration

cs-api-definition
public bool CanFinish { get; }

Property Value

bool

true if the user can finish the operation; otherwise, false.

CanHelp

Gets a value that indicates whether the user can receive help.

Declaration

cs-api-definition
public bool CanHelp { get; }

Property Value

bool

CanMoveCurrentToNext

Gets a value that indicates whether the user can move the current page to the next position.

Declaration

cs-api-definition
public bool CanMoveCurrentToNext { get; }

Property Value

bool

true if the user can move the current page to the next position; otherwise, false.

CanMoveCurrentToPrevious

Gets a value that indicates whether the user can move the current page to the previous position.

Declaration

cs-api-definition
public bool CanMoveCurrentToPrevious { get; }

Property Value

bool

true if the user can move the current page to the previous position; otherwise, false.

CommandProvider

Exposes a WizardCommandProvider.

Declaration

cs-api-definition
public WizardCommandProvider CommandProvider { get; set; }

Property Value

WizardCommandProvider

IsContentPreserved

Gets or sets a value indicating whether the state of the content of WizardPage will be preserved when selection is changed.

Declaration

cs-api-definition
public bool IsContentPreserved { get; set; }

Property Value

bool

SelectedPage

Gets or sets the SelectedPage.

Declaration

cs-api-definition
public WizardPage SelectedPage { get; set; }

Property Value

WizardPage

SelectedPageIndex

Gets or sets the SelectedPageIndex.

Declaration

cs-api-definition
public int SelectedPageIndex { get; set; }

Property Value

int

WizardPages

Returns a collection of wizard's pages.

Declaration

cs-api-definition
public WizardPageCollection WizardPages { get; }

Property Value

WizardPageCollection

Methods

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call .

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCancel(NavigationButtonsEventArgs)

Raises the Cancel event.

Declaration

cs-api-definition
protected virtual void OnCancel(NavigationButtonsEventArgs e)

Parameters

e

NavigationButtonsEventArgs

OnCompleted(WizardCompletedEventArgs)

Raises the Completed event.

Declaration

cs-api-definition
protected virtual void OnCompleted(WizardCompletedEventArgs e)

Parameters

e

WizardCompletedEventArgs

OnCompleting(WizardCompletingEventArgs)

Raises the Completing event.

Declaration

cs-api-definition
protected virtual void OnCompleting(WizardCompletingEventArgs e)

Parameters

e

WizardCompletingEventArgs

OnCreateAutomationPeer()

Returns an automation peer for this RadWizard.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

OnFinish(NavigationButtonsEventArgs)

Raises the Finish event.

Declaration

cs-api-definition
protected virtual void OnFinish(NavigationButtonsEventArgs e)

Parameters

e

NavigationButtonsEventArgs

OnHelp(NavigationButtonsEventArgs)

Raises the Help event.

Declaration

cs-api-definition
protected virtual void OnHelp(NavigationButtonsEventArgs e)

Parameters

e

NavigationButtonsEventArgs

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnMouseLeftButtonDown(MouseButtonEventArgs)

Called when the root MouseLeftButtonDown event is fired.

Declaration

cs-api-definition
protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)

Parameters

e

MouseButtonEventArgs

OnNext(NavigationButtonsEventArgs)

Raises the Next event.

Declaration

cs-api-definition
protected virtual void OnNext(NavigationButtonsEventArgs args)

Parameters

args

NavigationButtonsEventArgs

OnPageLoaded(WizardPage)

Raises the PageLoaded event.

Declaration

cs-api-definition
protected virtual void OnPageLoaded(WizardPage page)

Parameters

page

WizardPage

OnPrevious(NavigationButtonsEventArgs)

Raises the Previous event.

Declaration

cs-api-definition
protected virtual void OnPrevious(NavigationButtonsEventArgs args)

Parameters

args

NavigationButtonsEventArgs

OnSelectionChanged(SelectedPageChangedEventArgs)

Raises the SelectionChanged event.

Declaration

cs-api-definition
protected virtual void OnSelectionChanged(SelectedPageChangedEventArgs e)

Parameters

e

SelectedPageChangedEventArgs

OnSelectionChanging(SelectedPageChangingEventArgs)

Raises the SelectionChanging event.

Declaration

cs-api-definition
protected virtual void OnSelectionChanging(SelectedPageChangingEventArgs e)

Parameters

e

SelectedPageChangingEventArgs

ResetTheme()

Resets the theme.

Declaration

cs-api-definition
public void ResetTheme()

Events

Cancel

Occurs when the Cancel button has been clicked.

Declaration

cs-api-definition
public event EventHandler<NavigationButtonsEventArgs> Cancel

Event Value

EventHandler<NavigationButtonsEventArgs>

Completed

Occurs when the operation is completed.

Declaration

cs-api-definition
public event EventHandler<WizardCompletedEventArgs> Completed

Event Value

EventHandler<WizardCompletedEventArgs>

Completing

Occurs when the operation is about to be completed and allows you to cancel the operation.

Declaration

cs-api-definition
public event EventHandler<WizardCompletingEventArgs> Completing

Event Value

EventHandler<WizardCompletingEventArgs>

Finish

Occurs when the Finish button has been clicked.

Declaration

cs-api-definition
public event EventHandler<NavigationButtonsEventArgs> Finish

Event Value

EventHandler<NavigationButtonsEventArgs>

Help

Occurs when the Help button has been clicked.

Declaration

cs-api-definition
public event EventHandler<NavigationButtonsEventArgs> Help

Event Value

EventHandler<NavigationButtonsEventArgs>

Next

Occurs when the Next button has been clicked.

Declaration

cs-api-definition
public event EventHandler<NavigationButtonsEventArgs> Next

Event Value

EventHandler<NavigationButtonsEventArgs>

PageLoaded

Occurs when a new page is loaded.

Declaration

cs-api-definition
public event EventHandler<PageEventArgs> PageLoaded

Event Value

EventHandler<PageEventArgs>

Previous

Occurs when the Previous button has been clicked.

Declaration

cs-api-definition
public event EventHandler<NavigationButtonsEventArgs> Previous

Event Value

EventHandler<NavigationButtonsEventArgs>

SelectionChanged

Occurs when the selected page has changed.

Declaration

cs-api-definition
public event EventHandler<SelectedPageChangedEventArgs> SelectionChanged

Event Value

EventHandler<SelectedPageChangedEventArgs>

SelectionChanging

Occurs when the selected page is changing.

Declaration

cs-api-definition
public event EventHandler<SelectedPageChangingEventArgs> SelectionChanging

Event Value

EventHandler<SelectedPageChangingEventArgs>