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

RadSplitButton control provides the features, that ASP.NET: Button controls has.

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Navigation")]
[ToolboxBitmap(typeof(RadSplitButton), "Toolbox.Icons.SplitButton.png")]
[RequiredScript(typeof(jQueryPlugins))]
[RequiredScript(typeof(PostBackButtonBase))]
[ClientScriptResource("Telerik.Web.UI.RadSplitButton", "Telerik.Web.UI.Button.RadButtonScripts.js")]
[EmbeddedSkin("Button")]
[EmbeddedSkin("Button", "Default")]
[RequiredCss("Telerik.Web.UI.Skins.Common.fonticons.css", RenderMode.Classic, typeof(RadButton))]
[RequiredCss("Telerik.Web.UI.Skins.Common.fonticons.css", RenderMode.Lightweight, typeof(RadButton))]
public class RadSplitButton : PostBackButtonBase, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, IPostBackDataHandler, ISkinnableControl, IControl, IButtonControl, IPostBackEventHandler, INamingContainer

Inheritance: objectControlWebControlRadWebControlRadButtonBasePostBackButtonBaseRadSplitButton...

Implements: IAttributeAccessorIButtonControlIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorINamingContainerIParserAccessorIPostBackDataHandlerIPostBackEventHandlerIScriptControlISkinnableControlIUrlResolutionService...

Inherited Members PostBackButtonBase.RaisePostBackEvent(string)PostBackButtonBase.ValidatePage(string)PostBackButtonBase.RegisterForEventValidation()PostBackButtonBase.LoadPostData(string, NameValueCollection)PostBackButtonBase.GetPostbackEventReference()PostBackButtonBase.OnClick(ButtonClickEventArgs)PostBackButtonBase.OnCommand(ButtonCommandEventArgs)PostBackButtonBase.AutoPostBackPostBackButtonBase.CausesValidationPostBackButtonBase.CommandArgumentPostBackButtonBase.CommandNamePostBackButtonBase.PostBackUrlPostBackButtonBase.SingleClickPostBackButtonBase.SingleClickTextPostBackButtonBase.ValidationGroupPostBackButtonBase.UseSubmitBehaviorPostBackButtonBase.ClickPostBackButtonBase.CommandWebControl.AddAttributesToRender(HtmlTextWriter)WebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.LoadViewState(object)WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.SaveViewState()WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SupportsDisabledAttributeWebControl.SkinIDWebControl.TabIndexWebControl.TagKeyWebControl.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.AddParsedSubObject(object)Control.EnsureID()Control.OnInit(EventArgs)Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.OnPreRender(EventArgs)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()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 RadSplitButton()

Properties

Gets the object that controls the built-in confirmation dialog properties.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public RadButtonConfirmSettings ConfirmSettings { get; }

Gets or sets the template for the Button control.

C#
[TemplateContainer(typeof(RadSplitButton))]
[PersistenceMode(PersistenceMode.InnerProperty)]
public ITemplate ContentTemplate { get; set; }
Property Value:

An object implementing the ITemplate interface. The default value is a null reference (Nothing in Visual Basic), which indicates that this property is not set.

Gets the RadContextMenu instance of the SplitButton control.

C#
[Browsable(true)]
[PersistenceMode(PersistenceMode.InnerProperty)]
public virtual RadContextMenu ContextMenu { get; }

Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests

C#
public override bool EnableAjaxSkinRendering { get; set; }

Overrides: RadWebControl.EnableAjaxSkinRendering

If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.

When set to true enables support for WAI-ARIA

C#
[ClientControlProperty]
[ClientPropertyName("enableAriaSupport")]
public bool EnableAriaSupport { get; set; }

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

C#
public override bool EnableEmbeddedBaseStylesheet { get; set; }

Overrides: RadWebControl.EnableEmbeddedBaseStylesheet

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

Gets or sets the value, indicating whether to render script references to the embedded scripts or not.

C#
public override bool EnableEmbeddedScripts { get; set; }

Overrides: RadWebControl.EnableEmbeddedScripts

If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.

Gets or sets the value, indicating whether to render links to the embedded skins or not.

C#
public override bool EnableEmbeddedSkins { get; set; }

Overrides: RadWebControl.EnableEmbeddedSkins

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

Gets the object that controls the Primary and Secondary Icon related properties.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public ButtonIcon Icon { get; }

Gets or sets the name of the JavaScript function that will be called when the RadButton is clicked. The event is cancelable.

C#
[ClientControlEvent]
[ClientPropertyName("contextMenuItemClicked")]
public string OnClientContextMenuItemClicked { get; set; }

Controls wether the Text of a clicked ContextMenu item should become the button's Text.

C#
[ClientControlProperty]
[ClientPropertyName("persistChangesFromContextMenu")]
public bool PersistChangesFromContextMenu { get; set; }

Gets/Sets the primary appearance of the button.

C#
[ClientControlProperty]
[ClientPropertyName("primary")]
public bool Primary { get; set; }

Gets or sets the value, indicating whether to register with the ScriptManager control on the page.

C#
public override bool RegisterWithScriptManager { get; set; }

Overrides: RadWebControl.RegisterWithScriptManager

If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.

Gets or sets the skin name for the control user interface.

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

A string containing the skin name for the control user interface. The default is string.Empty.

Overrides: RadWebControl.Skin

If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.

Methods

C#
protected override void CreateChildControls()

Overrides: Control.CreateChildControls()

C#
protected override void DescribeComponent(IScriptDescriptor descriptor)
Parameters:descriptorIScriptDescriptor

Overrides: PostBackButtonBase.DescribeComponent(IScriptDescriptor)

C#
public virtual IEnumerable<JavaScriptConverter> GetJsConverters()
Returns:

IEnumerable<JavaScriptConverter>

C#
protected virtual void OnChildrenCreated()
C#
protected override void Render(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: RadWebControl.Render(HtmlTextWriter)

C#
protected override void RenderContents(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: RadButtonBase.RenderContents(HtmlTextWriter)

Events

Occurs after all child controls of the SplitButton control have been created. You can customize the control there, and add additional child controls.

C#
public event EventHandler ChildrenCreated