RadButtonList
RadButtonList class
Definition
Namespace:Telerik.Web.UI
Assembly:Telerik.Web.UI.dll
Syntax:
[ValidationProperty("SelectedItem")]
[RequiredScript(typeof(jQueryPlugins))]
[ClientScriptResource("Telerik.Web.UI.RadButtonList", "Telerik.Web.UI.Common.ButtonList.RadButtonListScripts.js")]
public abstract class RadButtonList : RadDataBoundControl, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, ISkinnableControl, IControl, IFeatureGroup, IPostBackDataHandler, INamingContainerInheritance: objectControlWebControlBaseDataBoundControlDataBoundControlRadDataBoundControlRadButtonList...
Derived Classes:
Implements:
Inherited Members
Constructors
protected RadButtonList()Fields
protected bool isSelectedIndexChangedProperties
Gets or sets a value that indicates whether list items are cleared before data binding.
public bool AppendDataBoundItems { get; set; }Gets the object that controls the Wai-Aria settings applied on the control's element.
[PersistenceMode(PersistenceMode.InnerProperty)]
public WaiAriaSettings AriaSettings { get; }Specifies if change of the selected item should postback.
public bool AutoPostBack { get; set; }Gets or sets a value indicating whether validation is performed when the selected item is changed.
public bool CausesValidation { get; set; }Defines the client events handlers.
[PersistenceMode(PersistenceMode.InnerProperty)]
public ButtonListClientEvents ClientEvents { get; }Gets or sets the number of columns to display in the control when the layout is Flow.
public int Columns { get; set; }The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()
protected override string CssClassFormatString { get; }Overrides:
Defines the data binding configuration of the control
[PersistenceMode(PersistenceMode.InnerProperty)]
public ButtonListDataBinding DataBindings { get; }Gets or sets the direction in which the items within the group are displayed.
public ButtonListDirection Direction { get; set; }Gets or sets a value indicating whether support for WAI-ARIA is enabled.
[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. This control features no skins, so this property must be set to false.
[Browsable(false)]
public override bool EnableEmbeddedBaseStylesheet { get; }Overrides:
Gets or sets the value, indicating whether to render links to the embedded skins or not. This control features no skins, so this property must be set to false.
[Browsable(false)]
public override bool EnableEmbeddedSkins { get; set; }Overrides:
Gets or sets the height of the control.
[ClientControlProperty]
[ClientPropertyName("height")]
public override Unit Height { get; set; }Overrides:
Gets the collection of items in the list control. An item has Text, Value, Selected and Enabled properties.
[PersistenceMode(PersistenceMode.InnerProperty)]
public ButtonListItemCollection Items { get; }A collection of list control items.
Used to define keyboard shortcut to focus the first list item.
[PersistenceMode(PersistenceMode.InnerProperty)]
public KeyboardNavigationSettings KeyboardNavigationSettings { get; }Gets or sets the layout in which the items are rendered. Possible values are Flow, OrderedList, UnorderedList. OrderedList and UnorderedList do not support Horizontal Direction and Columns.
public ButtonListLayout Layout { get; set; }Gets or sets the lowest ordinal index of the selected items in the control.
[Browsable(false)]
[ClientControlProperty]
[ClientPropertyName("selectedIndex")]
public int SelectedIndex { get; set; }Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.
[Browsable(false)]
public string SelectedValue { get; set; }public virtual string SmartPasteDescription { get; set; }protected override HtmlTextWriterTag TagKey { get; }Overrides:
Gets or sets the group of controls for which an item from the list causes validation when it posts back to the server.
[ClientControlProperty]
[ClientPropertyName("validationGroup")]
public string ValidationGroup { get; set; }Methods
protected override void AddAttributesToRender(HtmlTextWriter writer)Overrides:
Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason
protected override void ControlPreRender()Overrides:
protected override void CreateChildControls()Overrides:
protected override void DescribeComponent(IScriptDescriptor descriptor)Overrides:
Executed when post data is loaded from the request
protected override bool LoadPostData(string postDataKey, NameValueCollection postCollection)Overrides:
Raises the ItemCreated event of the control.
protected virtual void OnItemCreated(ButtonListEventArgs e)An EventArgs that contains the event data.
Raises the ItemDataBound event of the control.
protected virtual void OnItemDataBound(ButtonListEventArgs e)An EventArgs that contains the event data.
Raises the SelectedIndexChanged event of the control.
protected virtual void OnSelectedIndexChanged(EventArgs e)An EventArgs that contains the event data.
protected override void PerformDataBinding(IEnumerable data)Overrides:
Invokes the OnSelectedIndexChanged method, when the SelectedIndex property of the control has changed.
protected override void RaisePostDataChangedEvent()Overrides:
protected override void RenderContents(HtmlTextWriter writer)Overrides:
protected virtual void SetCheckableButtonProperties(CheckableButton checkableButton, ButtonListItem item)protected override void TrackViewState()Overrides:
Events
Adds or removes an event handler method from the ItemCreated event. The event is fired when an item is created on the server.
public event EventHandler<ButtonListEventArgs> ItemCreatedAdds or removes an event handler method from the ItemDataBound event. The event is fired when an item is data bound on the server.
public event EventHandler<ButtonListEventArgs> ItemDataBoundAdds or removes an event handler method from the SelectedIndexChanged event. The event is fired when the selected item changes between posts to the server.
public event EventHandler SelectedIndexChanged