New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
[EmbeddedSkin("Wizard", typeof(RadWizard))]
[EmbeddedSkin("Wizard", "Default", typeof(RadWizard))]
[RequiredCss("Telerik.Web.UI.Skins.Common.fonticons.css", RenderMode.Lightweight, typeof(RadWizard))]
[RequiredCss("Telerik.Web.UI.Skins.Common.fonticons.css", RenderMode.Mobile, typeof(RadWizard))]
[RequiredCss("Telerik.Web.UI.Skins.Common.MaterialRipple.css", RenderMode.Lightweight, typeof(RadButton))]
[RequiredCss("Telerik.Web.UI.Skins.Common.MaterialRipple.css", RenderMode.Mobile, typeof(RadButton))]
[RequiredScript(typeof(jQueryPlugins), 1)]
[RequiredScript(typeof(MaterialRipple))]
[ClientScriptResource("Telerik.Web.UI.RadWizard", "Telerik.Web.UI.Wizard.RadWizardScripts.js")]
[TelerikToolboxCategory("Container")]
[ToolboxBitmap(typeof(RadWizard), "Toolbox.Icons.Wizard.png")]
public class RadWizard : RadWebControl, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, IPostBackDataHandler, ISkinnableControl, IControl, IPostBackEventHandler

Inheritance: objectControlWebControlRadWebControlRadWizard

Implements: IAttributeAccessorIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorIParserAccessorIPostBackDataHandlerIPostBackEventHandlerIScriptControlISkinnableControlIUrlResolutionService...

Inherited Members WebControl.AddAttributesToRender(HtmlTextWriter)WebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.Render(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.RenderContents(HtmlTextWriter)WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SupportsDisabledAttributeWebControl.SkinIDWebControl.TabIndexWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind()Control.DataBind(bool)Control.DataBindChildren()Control.EnsureID()Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.BuildProfileTree(string, bool)Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

C#
public RadWizard()

Properties

Gets the active step.

C#
public RadWizardStep ActiveStep { get; }
Property Value:

The active step.

Gets or sets the index of the selected RadWizardStep.

C#
public int ActiveStepIndex { get; set; }
Property Value:

The index of the currently selected RadWizardStep. The default value is -1, which means that no RadWizardStep is selected.

Gets or sets the click active step.

C#
[ClientControlProperty]
[ClientPropertyName("_clickActiveStep")]
public bool ClickActiveStep { get; set; }
Property Value:

The click active step.

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

C#
protected override string CssClassFormatString { get; }

Overrides: RadWebControl.CssClassFormatString

Example:
C#
protected override string CssClassFormatString
{
       get
       {
           return "RadDock RadDock_{0} rdWTitle rdWFooter";
       }
}

Gets or sets the selected culture. Localization strings will be loaded based on this value.

C#
public CultureInfo Culture { get; set; }
Property Value:

The culture.

Gets or sets the display cancel button.

C#
public virtual bool DisplayCancelButton { get; set; }
Property Value:

The display cancel button.

Gets or sets the display navigationBar.

C#
[ClientControlProperty]
[ClientPropertyName("_displayNavigationBar")]
public bool DisplayNavigationBar { get; set; }
Property Value:

The display navigationBar.

Gets or sets the display navigation buttons.

C#
public bool DisplayNavigationButtons { get; set; }
Property Value:

The display navigation buttons.

Gets or sets the display progress bar.

C#
[ClientControlProperty]
[ClientPropertyName("_displayProgressBar")]
public bool DisplayProgressBar { get; set; }
Property Value:

The display progress bar.

Gets or sets a value indicating the position of the image within the step.

C#
public RadWizardImagePostion ImagePosition { get; set; }
Property Value:

One of the Telerik.Web.UI.RadWizardImagePostion?text=RadWizardImagePostion ++++++++++++++++Enumeration values. The default value is Left.

Gets the localization.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
[TypeConverter(typeof(ExpandableObjectConverter))]
public WizardButtons Localization { get; }
Property Value:

The localization.

Gets or sets a value indicating where RadWizard will look for its .resx localization files.

C#
public string LocalizationPath { get; set; }
Property Value:

The localization path.

Gets or sets the position of the NavigationBar.

C#
public RadWizardNavigationBarPosition NavigationBarPosition { get; set; }
Property Value:

The position of the NavigationBar. The default value is Top.

Gets or sets the position of the navigation buttons.

C#
public RadWizardNavigationButtonsPosition NavigationButtonsPosition { get; set; }
Property Value:

The position of the navigation buttons. The default value is Bottom.

The client-side event that is fired when some button is clicked.

C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("buttonClicked")]
public string OnClientButtonClicked { get; set; }
Property Value:

The on client button clicked.

The client-side cancelable event that is fired when some button is clicked.

C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("buttonClicking")]
public string OnClientButtonClicking { get; set; }
Property Value:

The on client button clicking.

Gets or sets a value indicating the client-side event handler that is called after the RadWizard client-side object is initialized.

C#
[ClientControlEvent]
[ClientPropertyName("load")]
public string OnClientLoad { get; set; }
Property Value:

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

If specified, the OnClienLoad client-side event handler is called after the wizard is fully initialized on the client.

A single parameter - the wizard client object - is passed to the handler.

This event cannot be cancelled.

Example:
C#
<p>&lt;script type="text/javascript"&gt;<br />
function onClientLoadHandler(sender)<br />
{<br />
       alert(sender.get_id());<br />
}<br />
&lt;/script&gt;</p>
<p>&lt;telerik:RadWizard ID="RadWizard1"<br />
runat= "server"<br />
    <strong>OnClientLoad="onClientLoadHandler"</strong>&gt;<br />
....<br />
&lt;/telerik:RadWizard&gt;</p>

Gets or sets the position of the ProgressBar.

C#
public RadWizardProgressBarPosition ProgressBarPosition { get; set; }
Property Value:

The position of the ProgressBar. The default value is Top.

Gets or sets the position of the ProgressPercent.

C#
public int ProgressPercent { get; set; }
Property Value:

The position of the ProgressPercent. The default value is 0.

Gets or sets a value indicating whether tabs should postback when clicked.

C#
[ClientControlProperty]
[ClientPropertyName("_renderedSteps")]
public RadWizardRenderedSteps RenderedSteps { get; set; }
Property Value:

True if tabs should postback; otherwise false. The default value is false.

RadWizard will postback provided one of the following conditions is met:

C#
protected override bool SupportsRenderingMode { get; }

Overrides: RadWebControl.SupportsRenderingMode

C#
protected override HtmlTextWriterTag TagKey { get; }

Overrides: WebControl.TagKey

Gets the wizard steps.

C#
[Browsable(false)]
[PersistenceMode(PersistenceMode.InnerProperty)]
public RadWizardStepCollection WizardSteps { get; }
Property Value:

The wizard steps.

Methods

C#
protected override void AddedControl(Control control, int index)
Parameters:controlControlindexint

Overrides: Control.AddedControl(Control, int)

C#
protected override void AddParsedSubObject(object obj)
Parameters:objobject

Overrides: Control.AddParsedSubObject(object)

C#
protected override ControlCollection CreateControlCollection()
Returns:

ControlCollection

Overrides: Control.CreateControlCollection()

C#
protected override IRenderer CreateControlRenderer()
Returns:

IRenderer

Overrides: RadWebControl.CreateControlRenderer()

Creates and returns a new wizard step.

C#
public virtual RadWizardStep CreateWizardStep()
Returns:

RadWizardStep

Gets a list with the active steps that in the order they have been activated.

C#
public ICollection GetHistory()
Returns:

ICollection

C#
protected string GetPostbackEventReference()
Returns:

string

Gets the index of the previous step.

C#
public int GetPreviousStepIndex()
Returns:

int

C#
protected override void LoadControlState(object savedState)
Parameters:savedStateobject

Overrides: Control.LoadControlState(object)

Executed when post data is loaded from the request

C#
protected override bool LoadPostData(string postDataKey, NameValueCollection postCollection)
Parameters:postDataKeystringpostCollectionNameValueCollectionReturns:

bool

Overrides: RadWebControl.LoadPostData(string, NameValueCollection)

C#
protected override void LoadViewState(object savedState)
Parameters:savedStateobject

Overrides: WebControl.LoadViewState(object)

Raises the CancelButtonClick event.

C#
protected void OnCancelButtonClick(WizardEventArgs e)
Parameters:eWizardEventArgs

The WizardEventArgs instance containing the event data.

Raises the FinishButtonClick event.

C#
protected void OnFinishButtonClick(WizardEventArgs e)
Parameters:eWizardEventArgs

The WizardEventArgs instance containing the event data.

C#
protected override void OnInit(EventArgs e)
Parameters:eEventArgs

Overrides: RadWebControl.OnInit(EventArgs)

Raises the NavigationBarButtonClick event.

C#
protected void OnNavigationBarButtonClick(WizardEventArgs e)
Parameters:eWizardEventArgs

The WizardEventArgs instance containing the event data.

Raises the NextButtonClick event.

C#
protected void OnNextButtonClick(WizardEventArgs e)
Parameters:eWizardEventArgs

The WizardEventArgs instance containing the event data.

C#
protected override void OnPreRender(EventArgs e)
Parameters:eEventArgs

Overrides: RadWebControl.OnPreRender(EventArgs)

Raises the PreviousButtonClick event.

C#
protected void OnPreviousButtonClick(WizardEventArgs e)
Parameters:eWizardEventArgs

The WizardEventArgs instance containing the event data.

C#
protected virtual void OnWizardStepCreated(WizardStepCreatedEventArgs eventArgs)
Parameters:eventArgsWizardStepCreatedEventArgs
C#
protected virtual void RaisePostBackEvent(string eventArgument)
Parameters:eventArgumentstring

Renders the HTML opening tag of the control to the specified writer. This method is used primarily by control developers.

C#
public override void RenderBeginTag(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

A HtmlTextWriter that represents the output stream to render HTML content on the client.

Overrides: RadWebControl.RenderBeginTag(HtmlTextWriter)

C#
protected override object SaveControlState()
Returns:

object

Overrides: Control.SaveControlState()

C#
protected override object SaveViewState()
Returns:

object

Overrides: WebControl.SaveViewState()

Events

Occurs when the active step has changed.

C#
public event EventHandler ActiveStepChanged

Occurs when an Cancel button has been clicked.

C#
public event WizardEventHandler CancelButtonClick

Occurs when an Finish button has been clicked.

C#
public event WizardEventHandler FinishButtonClick

Occurs when an NavigationBar button has been clicked.

C#
public event WizardEventHandler NavigationBarButtonClick

Occurs when an Next button has been clicked.

C#
public event WizardEventHandler NextButtonClick

Occurs when an Previous button has been clicked.

C#
public event WizardEventHandler PreviousButtonClick

Occurs when wizard steps are added programmatically to the RadWizard control. It also occurs after postback when the RadWizard control recreates its page views from ViewState.

C#
public event WizardStepCreatedEventHandler WizardStepCreated

Use this event when you need to create page views from code behind. Controls added dynamically should be created in the WizardStepCreated event handler.

Example:
cs-api-definition
protected void Page_Load(object sender, System.EventArgs e)
{
if (!Page.IsPostBack)
{
RadWizardStep step = new RadWizardStep();
step.ID = "dynamicWizardStep";
RadWizard1.WizardSteps.Add(step);
}
}

protected void RadWizard1_WizardStepCreated(object sender, Telerik.Web.UI.WizardStepCreatedEventArgs e)
{
Label l = new Label();
l.ID = "dynamicLabel";
l.Text = "Programmatically created label";
e.WizardStep.Controls.Add(l);
}