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

Telerik.Web.UI.RadTabStrip

Remarks

The RadTabStripcontrol is used to display a list of tabs in a Web Forms page and is often used in combination with a Telerik.Web.UI.RadMultiPage RadMultiPagecontrol for building tabbed interfaces. The RadTabStripcontrol supports the following features: bullet Databinding that allows the control to be populated from various datasourcesProgrammatic access to the RadTabStripobject model which allows to dynamic creation of tabstrips, populate h tabs, set properties.Customizable appearance through built-in or user-defined skins.TabsThe RadTabStripcontrol is made up of tree of tabs represented by Telerik.Web.UI.RadTab RadTabobjects. Tabs at the top level (level 0) are called root tabs. A tab that has a parent tab is called a child tab. All root tabs are stored in the P:Telerik.Web.UI.RadTabStrip.Tabs Tabscollection. Child tabs are stored in a parent tab's P:Telerik.Web.UI.RadTab.Tabs Tabscollection. Each tab has a P:Telerik.Web.UI.RadTab.Text Textand a P:Telerik.Web.UI.RadTab.Value Valueproperty. The value of the P:Telerik.Web.UI.RadTab.Text Textproperty is displayed in the RadTabStripcontrol, while the P:Telerik.Web.UI.RadTab.Value Valueproperty is used to store any additional data about the tab, such as data passed to the postback event associated with the tab. When clicked, a tab can navigate to another Web page indicated by the P:Telerik.Web.UI.RadTab.NavigateUrl NavigateUrlproperty. You can find information on the Server-side API of RadTabStrip at https://docs.telerik.com/devtools/aspnet-ajax/controls/tabstrip/server-side-programming/events .

Inheritance Hierarchy

System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.BaseDataBoundControl
System.Web.UI.WebControls.DataBoundControl
Telerik.Web.UI.RadDataBoundControl : IControl, IControlResolver, IFeatureGroup, IPostBackDataHandler, IScriptControl, ISkinnableControl
Telerik.Web.UI.ControlItemContainer : IControlItemContainer, INamingContainer, IXmlSerializable
Telerik.Web.UI.HierarchicalControlItemContainer
Telerik.Web.UI.RadTabStrip : IPostBackEventHandler, IRadTabContainer

Properties

Align `TabStripAlign`

Gets or sets the alignment of the tabs in the RadTabStrip control.

AppendDataBoundItems `Boolean`

Gets or sets a value that indicates whether child tabs are cleared before data binding.

Remarks

The AppendDataBoundTabs property allows you to add items to the RadTabStrp control before data binding occurs. After data binding, the items collection contains both the items from the data source and the previously added items.The value of this property is stored in view state.

AriaSettings `WaiAriaSettings`

Gets the object that controls the Wai-Aria settings applied on the control's element.

AutoPostBack `Boolean`

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

Remarks

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

                       The AutoPostBack property is set to true.
                   
                       The user has subscribed to the TabClick event.

CausesValidation `Boolean`

Gets or sets a value indicating whether validation is performed when a tab within the RadTabStrip control is selected.

Remarks

By default, page validation is performed when a tab is selected. Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. You can specify or determine whether validation is performed on both the client and the server when a tab is clicked by using the CausesValidation property. To prevent validation from being performed, set the CausesValidation property to false.

CausesValidation `Boolean`

Gets or sets a value indicating whether validation is performed when an item within the control is selected.

Remarks

By default, page validation is performed when an item is selected. Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. You can specify or determine whether validation is performed on both the client and the server when an item is clicked by using the CausesValidation property. To prevent validation from being performed, set the CausesValidation property to false.

ClickSelectedTab `RadTab`

Gets or sets a value indicating whether the tabstrip should postback when the user clicks the currently selected tab.

ClientChanges `IList`1`

Gets a list of all client-side changes (adding a tab, removing a tab, changing a tab's property) which have occurred.

Remarks

You can use the ClientChanges property to respond to client-side modifications such as adding a new tabremoving existing tabclearing the children of a tab or the control itselfchanging a property of the tab The ClientChanges property is available in the first postback (ajax) request after the client-side modifications have taken place. After this moment the property will return empty list.

ClientDataSourceID `String`

Gets or sets ID of ClientDataSource control that is used for client side binding

ClientIDMode `ClientIDMode`

This property is overridden in order to support controls which implement INamingContainer. The default value is changed to "AutoID".

CssClassFormatString `String`

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

DataBindings `RadTabBindingCollection`

Gets a collection of objects that define the relationship between a data item and the tab it is binding to.

DataFieldID `String`

Gets or sets the field from the data source which is the "child" column in the "parent-child" relationship used to databind the RadTabStrip control.

Remarks

RadTabStrip requires both DataFieldID and DataFieldParentID properties to be set in order to be hierarchically databound.

DataFieldParentID `String`

Gets or sets the field from the data source which is the "parent" column in the "parent-child" relationship used to databind the RadTabStrip control.

Remarks

RadTabStrip requires both DataFieldID and DataFieldParentID properties to be set in order to be hierarchically databound.

                    The value of the column specified by DataFieldParentID must be null (Nothing) for root tabs. This is a requirement
                    for databinding RadTabStrip.

DataNavigateUrlField `String`

Gets or sets the field of the data source that provides the URL to which tabs navigate.

Remarks

Use the DataNavigateUrlField property to specify the field of the data source (in most cases the name of the database column) which provides the values for the NavigateUrl property of databound tabs. The DataNavigateUrlField property is taken into account only during data binding. If the DataNavigateUrlField property is not set the NavigateUrl property of databound tabs will have its default value - empty string.

DataTextField `String`

Gets or sets the field of the data source that provides the text content of the tabs.

Remarks

Use the DataTextField property to specify the field of the data source (in most cases the name of the database column) which provides values for the Text property of databound tabs. The DataTextField property is taken into account only during data binding.

DataTextFormatString `String`

Gets or sets the formatting string used to control how text to the tabstrip control is displayed.

Remarks

Use the DataTextFormatString property to provide a custom display format for text of the tabs. The data format string consists of two parts, separated by a colon, in the form { A: Bxx }. For example, the formatting string {0:F2} would display a fixed point number with two decimal places.

                   The entire string must be enclosed in braces to indicate that it is a format string and not a literal string.
                   Any text outside the braces is displayed as literal text.
               
                   The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.
                   This value can only be set to 0.

DataValueField `String`

Gets or sets the field of the data source that provides the value of the tabs.

Remarks

Use the DataValueField property to specify the field of the data source (in most cases the name of the database column) which provides the values for the Value property of databound tabs. The DataValueField property is taken into account only during data binding. If the DataValueField property is not set the Value property of databound tabs will have its default value - empty string.

EnableAjaxSkinRendering `String`

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

Remarks

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.

EnableAriaSupport `Boolean`

When set to true enables support for WAI-ARIA

EnableDragToReorder `Boolean`

Gets or sets a value indicating whether reording with dragging should be enabled.

EnableEmbeddedBaseStylesheet `Boolean`

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

Remarks

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

EnableEmbeddedScripts `Boolean`

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

Remarks

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

EnableEmbeddedSkins `String`

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

Remarks

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

EnableRippleEffect `Boolean`

Returns true if ripple effect should be added

EnableSubLevelStyles `Boolean`

Controls whether the subitems of the tabstrip will have different styles than the main items.

InnermostSelectedTab `RadTab`

Gets the innermost selected tab in a hierarchical RadTabStrip control.

Remarks

In hierarchical tabstrips this property returns the innermost selected tab.

IsSkinSet `String`

For internal use.

KeyboardNavigationSettings `KeyboardNavigationSettings`

Used to customize the keyboard navigation functionality.

MaxDataBindDepth `Int32`

Gets or sets the maximum number of levels to bind to the RadTabStrip control.

Remarks

When binding the RadTabStrip control to a data source, use the MaxDataBindDepth property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only the root tabs and their immediate children. All remaining records in the data source are ignored.

MultiPage `RadMultiPage`

Gets the associated RadMultiPage control if the MultiPageID property is set.

MultiPageID `String`

Gets or sets the ID of the RadMultiPage control that will be controlled by the current RadTabStrip control.

Remarks

You should use different value depending on the following conditions:

                       Use the ID property of the RadMuitiPage control if the RadMultiPage control is in
                       the same INamingContainer (user control, page, content page, master page) as the current RadTabStrip control.
                   
                       Use the UniqueID property of the RadMuitiPage control if the RadMultiPage
                       control is in a different INamingContainer (user control, page, content page, master page) than
                       the current RadTabStrip control.

ODataDataSourceID `String`

Gets or sets the ODataDataSource used for data binding.

OnClientContextMenu `String`

Gets or sets a value indicating the client-side event handler that is called before the browser context menu shows (after right-clicking an item).

Remarks

Use the OnClientContextMenu property to specify a JavaScript function that will be executed before the context menu shows after right clicking a tab.Two parameters are passed to the handlersender (the client-side RadTabStrip object) eventArgs with two properties tab - the instance of the selected tabdomEvent - the browser DOM event

OnClientDoubleClick `String`

Gets or sets a value indicating the client-side event handler that is called when the user double-clicks a tab.

Remarks

Use the OnClientDoubleClick property to specify a JavaScript function that will be executed when the user double-clicks a tab. Two parameters are passed to the handlersender (the client-side RadTabStrip object) eventArgs with two properties tab - the instance of the selected tabdomEvent - the browser DOM event

OnClientLoad `String`

Gets or sets the name of the javascript function called when the control is fully initialized on the client side.

Remarks

Use the OnClientLoad property to specify a JavaScript function that is executed after the control is initialized on the client side. A single parameter is passed to the handler, which is the client-side RadTabStrip object.

OnClientMouseOut `String`

Gets or sets a value indicating the client-side event handler that is called when the mouse leaves a tab in the RadTabStrip control.

Remarks

Use the OnClientMouseOut property to specify a JavaScript function that is executed whenever the user moves the mouse away from a particular tab in the RadTabStrip control.Two parameters are passed to the handler:sender (the client-side RadTabStrip object); eventArgs with two properties:tab - the instance of the tab we are moving away from;domEvent - the instance of the browser event.

OnClientMouseOver `String`

Gets or sets a value indicating the client-side event handler that is called when the mouse hovers a tab in the RadTabStrip control.

Remarks

Use the OnClientMouseOver property to specify a JavaScript function that is called when the user hovers a tab with the mouse.Two parameters are passed to the handler:sender (the client-side RadTabStrip object); eventArgs with two properties tab - the instance of the tab that is being hovereddomEvent - the instance of the browser event.

OnClientReordered `String`

OnClientReordering `String`

OnClientTabDragStart `String`

OnClientTabSelected `String`

Gets or sets a value indicating the client-side event handler that is called after selecting a tab.

Remarks

Use the OnClientTabSelected property to specify a JavaScript function that will be executed after a tab is selected - either by left-clicking it with a mouse or hitting enter after tabbing to that tab.Two parameters are passed to the handlersender (the client-side RadTabStrip object) eventArgs with one property tab - the instance of the selected tab

OnClientTabSelecting `String`

Gets or sets a value indicating the client-side event handler that is called just prior to selecting a tab.

Remarks

Use the OnClientTabSelecting property to specify a JavaScript function that will be executed prior to tab selecting - either by left-clicking it with a mouse or hitting enter after tabbing to that tab. You can cancel that event (prevent tab selecting) by seting the cancel property of the event argument to true. Two parameters are passed to the handlersender (the client-side RadTabStrip object) eventArgs with one property tab - the instance of the selected tabcancel - whether to cancel the event

OnClientTabUnSelected `String`

Gets or sets a value indicating the client-side event handler that is called after a tab is unselected (i.e. the user has selected another tab).

Remarks

Use the OnClientTabUnSelected property to specify a JavaScript function that is executed after a tab is unselected.Two parameters are passed to the handler:sender (the client-side RadTabStrip object); eventArgs with one property:tab - the instance of the tab which is unselected;

Orientation `TabStripOrientation`

Gets or sets a value indicating the orientation of child tabs within the RadTabStrip control.

PerTabScrolling `Boolean`

Gets or sets a value indicating whether the tabstrip should scroll directly to the next tab.

Remarks

By default tabs are scrolled smoothly. If you want the tabstrip to scroll directly to the next (or previous) tab set this property to true. This property is applicable when the ScrollChildren property is set to true; otherwise it is ignored.

PostBackUrl `String`

Gets or sets the URL of the page to post to from the current page when a tab from the tabstrip is clicked.

PostBackUrl `String`

Gets or sets the URL of the page to post to from the current page when a tab from the tabstrip is clicked.

RegisterWithScriptManager `Boolean`

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

Remarks

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

RenderMode `RenderMode`

Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css. If the set value is Auto use ResolvedRenderMode to receive the actual RenderMode with respect to the user angent of the current request.

Remarks

Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.

ReorderTabsOnSelect `RadTabCollection`

Gets or sets a value indicating whether the row of the selected tab should move to the bottom.

Remarks

Use the ReorderTabsOnSelect property to mimic the behavior of the Windows tabstrip control.

ResolvedRenderMode `RenderMode`

Returns resolved RenderMode should the original value was Auto

RuntimeSkin `String`

Gets the real skin name for the control user interface. If Skin is not set, returns "Default", otherwise returns Skin.

ScrollButtonsPosition `TabStripScrollButtonsPosition`

The position of the scroll buttons with regards to the tab band.

Remarks

This property is applicable when the ScrollChildren property is set to true; otherwise it is ignored.

ScrollChildren `Boolean`

Gets or sets a value indicating whether the immediate children of the RadTabStrip control will be scrollable.

ScrollPosition `Int32`

Gets or sets the position of the scrollable band of tabs relative to the beginning of the scrolling area.

Remarks

This property is applicable when the ScrollChildren property is set to true; otherwise it is ignored.

SelectedIndex `Int32`

Gets or sets the index of the selected child tab.

Remarks

Use the SelectedIndex property to programmatically specify the selected child tab in a IRadTabContainer (RadTabStrip or RadTab). To clear the selection set the SelectedIndex property to -1.

SelectedTab `RadTab`

Gets the selected child tab.

ShowBaseLine `Boolean`

Shows or hides the image at the base of the first level of tabs.

Skin `String`

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

Remarks

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.

Tabs `RadTabCollection`

Gets a RadTabCollection object that contains the root tabs of the current RadTabStrip control.

Remarks

Use the Tabs property to access the child tabs of RadTabStrip. You can also use the Tabs property to manage the root tabs. You can add, remove or modify tabs from the Tabs collection.

TabTemplate `ITemplate`

Gets or sets the template for displaying all tabs in the control.

UnSelectChildren `Boolean`

Gets or sets a value determining whether child tabs are unselected when a parent tab is unselected.

ValidationGroup `String`

Gets or sets the name of the validation group to which this validation control belongs.

Remarks

This property works only when CausesValidation is set to true.

ValidationGroup `String`

Gets or sets the name of the validation group to which this validation control belongs.

Remarks

This property works only when CausesValidation is set to true.

Methods

AddProperty

Adds the property to the IScriptDescriptor, if it's value is different from the given default.

Parameters

descriptor `Telerik.Web.UI.IScriptDescriptor`

The descriptor to add the property to.

name `System.String`

The property name.

value `System.Object`

The current value of the property.

defaultValue `System.Object`

The default value.

Returns

System.Void

ApplyConditionalRendering

Use this from RenderContents of the inheritor

Returns

System.Void

ControlPreRender

Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason

Returns

System.Void

DescribeRenderingMode

Should be used by inheritors

Returns

System.Void

FindTab

Returns the first RadTab that matches the conditions defined by the specified predicate. The predicate should returns a boolean value.

Parameters

match `System.Predicate{Telerik.Web.UI.RadTab}`

The Predicate <> that defines the conditions of the element to search for.

Returns

Telerik.Web.UI.RadTab

FindTabByText

Searches the RadTabStrip control for the first RadTab whose Text property is equal to the specified value.

Parameters

text `System.String`

The value to search for.

Returns

Telerik.Web.UI.RadTab A RadTab whose Text property is equal to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned.

FindTabByText

Searches the RadTabStrip control for the first RadTab whose Text property is equal to the specified value.

Parameters

text `System.String`

The value to search for.

ignoreCase `System.Boolean`

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

Telerik.Web.UI.RadTab A RadTab whose Text property is equal to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned.

FindTabByUrl

Searches the RadTabStrip control for the first RadTab whose NavigateUrl property is equal to the specified value.

Parameters

url `System.String`

The URL to search for.

Returns

Telerik.Web.UI.RadTab A RadTab whose NavigateUrl property is equal to the specifed value. If a tab is not found, null (Nothing in Visual Basic) is returned.

FindTabByValue

Searches the RadTabStrip control for the first RadTab whose Value property is equal to the specified value.

Parameters

value `System.String`

The value to search for.

Returns

Telerik.Web.UI.RadTab A RadTab whose Value property is equal to the specifed value. If a tab is not found, null (Nothing in Visual Basic) is returned.

FindTabByValue

Searches the RadTabStrip control for the first RadTab whose Value property is equal to the specified value.

Parameters

value `System.String`

The value to search for.

ignoreCase `System.Boolean`

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

Telerik.Web.UI.RadTab A RadTab whose Value property is equal to the specifed value. If a tab is not found, null (Nothing in Visual Basic) is returned.