ClassRadWizard
Represents a wizard control that helps you break a complex process into separate steps, providing navigation buttons and page management capabilities.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadWizard : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadWizard
Implements:
Inherited Members
Constructors
RadWizard()
Initializes a new instance of the RadWizard class.
Declaration
public RadWizard()
Properties
BackButton
Gets the command area's back button element.
Declaration
[Browsable(false)]
public RadButtonElement BackButton { get; }
Property Value
CancelButton
Gets the command area's cancel button element.
Declaration
[Browsable(false)]
public RadButtonElement CancelButton { get; }
Property Value
CommandArea
Gets the command area element that contains the navigation buttons.
Declaration
[Browsable(false)]
public WizardCommandArea CommandArea { get; }
Property Value
CommandAreaHeight
Gets or sets the height of the command area. A negative value makes the command area autosize.
CompletionImage
Gets or sets the image displayed on completion pages.
CompletionImageBackgroundShape
Gets or sets the background image shape for completion pages.
Declaration
[Browsable(false)]
public RadImageShape CompletionImageBackgroundShape { get; set; }
Property Value
CompletionImageElement
Gets the element containing the image displayed on completion pages.
Declaration
[Browsable(false)]
public LightVisualElement CompletionImageElement { get; }
Property Value
CompletionImageLayout
Gets or sets the layout of the completion page image.
Declaration
[Browsable(false)]
public ImageLayout CompletionImageLayout { get; set; }
Property Value
CompletionPage
Gets or sets the completion page of the wizard, which is typically displayed last in the wizard sequence.
Declaration
public WizardCompletionPage CompletionPage { get; set; }
Property Value
DefaultSize
Gets the default size for this control.
Declaration
protected override Size DefaultSize { get; }
Property Value
Overrides
EnableAeroStyle
Gets or sets a value indicating whether the Aero style should be applied when the control is in Wizard Aero mode.
FinishButton
Gets the command area's finish button element.
Declaration
[Browsable(false)]
public RadButtonElement FinishButton { get; }
Property Value
HelpButton
Gets the command area's help button element.
Declaration
[Browsable(false)]
public LightVisualElement HelpButton { get; }
Property Value
HideCompletionImage
Gets or sets a value indicating whether the image on completion pages should be hidden.
HideWelcomeImage
Gets or sets a value indicating whether the image on welcome pages should be hidden.
Mode
Gets or sets the mode of the wizard control, determining its visual appearance and behavior.
Declaration
[Browsable(true)]
public WizardMode Mode { get; set; }
Property Value
NextButton
Gets the command area's next button element.
Declaration
[Browsable(false)]
public RadButtonElement NextButton { get; }
Property Value
PageHeaderElement
Gets the page header element that displays the title and description of the current page.
Declaration
[Browsable(false)]
public WizardPageHeaderElement PageHeaderElement { get; }
Property Value
PageHeaderHeight
Gets or sets the height of the page header. A negative value makes the page header autosize.
PageHeaderIcon
Gets or sets the icon displayed in the page header.
PageHeaderIconAlignment
Gets or sets the alignment of the page header's icon.
Declaration
[Browsable(false)]
public ContentAlignment PageHeaderIconAlignment { get; set; }
Property Value
PageHeaderTextVisibility
Gets or sets the visibility of the page header's text element.
Declaration
[Browsable(false)]
public ElementVisibility PageHeaderTextVisibility { get; set; }
Property Value
PageTitleTextVisibility
Gets or sets the visibility of the page header's title element.
Declaration
[Browsable(false)]
public ElementVisibility PageTitleTextVisibility { get; set; }
Property Value
Pages
Gets the collection of wizard pages contained in this RadWizard.
Declaration
[Browsable(true)]
public WizardPageCollection Pages { get; }
Property Value
SelectedPage
Gets or sets the currently selected wizard page.
Declaration
[Browsable(false)]
public WizardPage SelectedPage { get; set; }
Property Value
WelcomeImage
Gets or sets the image displayed on welcome pages.
WelcomeImageBackgroundShape
Gets or sets the background image shape for welcome pages.
Declaration
[Browsable(false)]
public RadImageShape WelcomeImageBackgroundShape { get; set; }
Property Value
WelcomeImageElement
Gets the element containing the image displayed on welcome pages.
Declaration
[Browsable(false)]
public LightVisualElement WelcomeImageElement { get; }
Property Value
WelcomeImageLayout
Gets or sets the layout of the welcome page image.
Declaration
[Browsable(false)]
public ImageLayout WelcomeImageLayout { get; set; }
Property Value
WelcomePage
Gets or sets the welcome page of the wizard, which is typically displayed first in the wizard sequence.
Declaration
public WizardWelcomePage WelcomePage { get; set; }
Property Value
WizardElement
Gets the RadWizardElement which encapsulates the UI representation and functionality of the control.
Declaration
[Browsable(false)]
public RadWizardElement WizardElement { get; }
Property Value
Methods
CreateAccessibilityInstance()
Creates an accessibility object for this control.
Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
A new RadWizardAccessibleObject if accessibility is enabled; otherwise, the base accessibility object.
Overrides
CreateChildItems(RadElement)
Creates the child items of the wizard control, including the main wizard element.
Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
parent
The parent element to which the child items will be added.
Overrides
Dispose(bool)
Releases the unmanaged resources used by the RadWizard and optionally releases the managed resources.
Declaration
protected override void Dispose(bool disposing)
Parameters
disposing
true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides
GiveFocusToNavigationButtonsLeft()
Determines whether the focus should go to the navigation buttons when the user presses the Left arrow key.
Declaration
protected virtual bool GiveFocusToNavigationButtonsLeft()
Returns
true if the focus should go to the navigation buttons; otherwise, false.
GiveFocusToNavigationButtonsRight()
Determines whether the focus should go to the navigation buttons when the user presses the Right arrow key.
Declaration
protected virtual bool GiveFocusToNavigationButtonsRight()
Returns
true if the focus should go to the navigation buttons; otherwise, false.
GiveFocusToNavigationButtonsShiftTab()
Determines whether the focus should go to the navigation buttons when the user presses Shift and Tab.
Declaration
protected virtual bool GiveFocusToNavigationButtonsShiftTab()
Returns
true if the focus should go to the navigation buttons; otherwise, false.
GiveFocusToNavigationButtonsTab()
Determines whether the focus should go to the navigation buttons when the user presses Tab.
Declaration
protected virtual bool GiveFocusToNavigationButtonsTab()
Returns
true if the focus should go to the navigation buttons; otherwise, false.
OnCancel(EventArgs)
Raises the Cancel event.
OnFinish(EventArgs)
Raises the Finish event.
OnHelp(EventArgs)
Raises the Help event.
OnLostFocus(EventArgs)
Raises the LostFocus event.
OnModeChanged(ModeChangedEventArgs)
Raises the ModeChanged event.
Declaration
protected virtual void OnModeChanged(ModeChangedEventArgs e)
Parameters
e
A ModeChangedEventArgs that contains the event data.
OnModeChanging(ModeChangingEventArgs)
Raises the ModeChanging event.
Declaration
protected virtual void OnModeChanging(ModeChangingEventArgs e)
Parameters
e
A ModeChangingEventArgs that contains the event data.
OnNext(WizardCancelEventArgs)
Raises the Next event.
Declaration
protected virtual void OnNext(WizardCancelEventArgs e)
Parameters
e
A WizardCancelEventArgs that contains the event data.
OnPrevious(WizardCancelEventArgs)
Raises the Previous event.
Declaration
protected virtual void OnPrevious(WizardCancelEventArgs e)
Parameters
e
A WizardCancelEventArgs that contains the event data.
OnSelectedPageChanged(object, SelectedPageChangedEventArgs)
Raises the SelectedPageChanged event.
Declaration
protected virtual void OnSelectedPageChanged(object sender, SelectedPageChangedEventArgs e)
Parameters
sender
The source of the event.
e
A SelectedPageChangedEventArgs that contains the event data.
OnSelectedPageChanging(object, SelectedPageChangingEventArgs)
Raises the SelectedPageChanging event.
Declaration
protected virtual void OnSelectedPageChanging(object sender, SelectedPageChangingEventArgs e)
Parameters
sender
The source of the event.
e
A SelectedPageChangingEventArgs that contains the event data.
ProcessDialogKey(Keys)
Processes a dialog key, handling navigation between wizard pages and buttons.
ScaleControl(SizeF, BoundsSpecified)
Scales the control and its child controls by the specified factor.
Declaration
protected override void ScaleControl(SizeF factor, BoundsSpecified specified)
Parameters
factor
The factor by which the height and width of the control and its child controls is to be scaled.
specified
A BoundsSpecified value that specifies the bounds of the control to use when defining its size and position.
Overrides
SelectFirstWizardControl()
Selects the first wizard control in the tab order.
Declaration
protected virtual void SelectFirstWizardControl()
SelectLastWizardControl()
Selects the last wizard control in the tab order.
Declaration
protected virtual bool SelectLastWizardControl()
Returns
true if a control was selected; otherwise, false.
SelectNextPage()
Navigates to the next wizard page in the sequence.
Declaration
public void SelectNextPage()
SelectPreviousPage()
Navigates to the previous wizard page in the sequence.
Declaration
public void SelectPreviousPage()
UnWireEvents()
Removes the event handlers for the wizard element and its child components.
Declaration
protected virtual void UnWireEvents()
WireEvents()
Wires up the event handlers for the wizard element and its child components.
Declaration
protected virtual void WireEvents()
Events
Cancel
Occurs when the Cancel command button is clicked.
Finish
Occurs when the Finish command button is clicked.
Help
Occurs when the Help command button is clicked.
ModeChanged
Occurs after the mode of the RadWizard is changed.
Declaration
public event ModeChangedEventHandler ModeChanged
Event Value
ModeChanging
Occurs before the mode of the RadWizard is changed.
Declaration
public event ModeChangingEventHandler ModeChanging
Event Value
Next
Occurs when the Next command button is clicked.
Declaration
public event WizardCancelEventHandler Next
Event Value
Previous
Occurs when the Previous command button is clicked.
Declaration
public event WizardCancelEventHandler Previous
Event Value
SelectedPageChanged
Occurs after the selected page of the RadWizard is changed.
Declaration
public event SelectedPageChangedEventHandler SelectedPageChanged
Event Value
SelectedPageChanging
Occurs before the selected page of the RadWizard is changed.
Declaration
public event SelectedPageChangingEventHandler SelectedPageChanging
Event Value