New to Telerik UI for ASP.NET AJAXStart a free 30-day trial

Telerik.Web.UI.RadTab

Represents a tab in the Telerik.Web.UI.RadTabStrip RadTabStripcontrol.

Remarks

The Telerik.Web.UI.RadTabStrip RadTabStripcontrol is made up of tabs. Tabs which are immediate children of the tabstrip are root tabs. tabs which are children of root tabs are child tabs. A tab usually stores data in two properties, the P:Telerik.Web.UI.RadTab.Text Textproperty and the P:Telerik.Web.UI.RadTab.Value Valueproperty. The value of the P:Telerik.Web.UI.RadTab.Text Textproperty is displayed in the Telerik.Web.UI.RadTabStrip RadTabStripcontrol, and the P:Telerik.Web.UI.RadTab.Value Valueproperty is used to store additional data. To create tabs, use one of the following methods:bullet Use declarative syntax to define tabs inline in your page or user control. Use one of the constructors to dynamically create new instances of the Telerik.Web.UI.RadTab RadTabclass. These tabs can then be added to the Tabscollection of another tab or tabstrip. Data bind the Telerik.Web.UI.RadTabStrip RadTabStripcontrol to a data source. When the user clicks a tab, the Telerik.Web.UI.RadTabStrip RadTabStripcontrol can navigate to a linked Web page, post back to the server or select that tab. If the P:Telerik.Web.UI.RadTab.NavigateUrl NavigateUrlproperty of a tab is set, the RadTabStripcontrol navigates to the linked page. By default, a linked page is displayed in the same window or frame. To display the linked content in a different window or frame, use the P:Telerik.Web.UI.RadTab.Target Targetproperty.

Inheritance Hierarchy

  • System.Object
  • System.Web.UI.Control
  • System.Web.UI.WebControls.WebControl
  • Telerik.Web.UI.ControlItem : IMarkableStateManager, INamingContainer, IStateManager, IXmlSerializable
  • Telerik.Web.UI.NavigationItem : IControlItemContainer
  • Telerik.Web.UI.RadTab : IRadTabContainer

Properties

AccessKey String

Gets or sets the access key that allows you to quickly navigate to the Web server control.

ChildGroupCssClass String

Gets or sets the Cascading Style Sheet (CSS) class applied to the HTML element containing the child tabs.

Remarks

Tabs are rendered as LI (list item) HTML elements inside a UL (unordered list). The CSS class specified by the ChildGroupCssClass property is applied to the UL tag.

DataItem Object

Gets the data item that is bound to the tab

Remarks

This property is applicable only during data binding. Use it along with the TabDataBound event to perform additional mapping of fields from the data item to RadTab properties.

DisabledCssClass String

Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is disabled.

Remarks

By default the visual appearance of disabled tabs is defined in the skin CSS file. You can use the DisabledCssClass property to specify unique appearance for the tab when it is disabled.

DisabledImageUrl String

Gets or sets the URL to an image which is displayed when the tab is disabled (its Enabled property is set to false).

Remarks

Use the DisabledImageUrl property to specify a custom image that will be displayed when the current tab is disabled. Setting the DisabledImageUrl property required the ImageUrl property to be set beforehand.

                   If the DisabledImageUrl property is not set the value of the ImageUrl
                   will be used instead.

HoveredCssClass String

Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is hovered with the mouse.

Remarks

By default the visual appearance of hovered tabs is defined in the skin CSS file. You can use the HoveredCssClass property to specify unique appearance for the tab when it is hovered.

HoveredImageUrl String

Gets or sets the URL to an image which is displayed when the user hovers the current tab with the mouse.

Remarks

Use the HoveredImageUrl property to specify a custom image that will be displayed when the user hovers the tab with the mouse. Setting the HoveredImageUrl property required the ImageUrl property to be set beforehand.

                   If the HoveredImageUrl property is not set the value of the ImageUrl
                   will be used instead.

ID String

The ID property is reserved for internal use. Please use the Value property or use the Attributes collection if you need to assign custom data to the item.

ImageUrl String

Gets or sets the URL to an image which is displayed next to the text of a tab.

Remarks

Use the ImageUrl property to specify a custom image that will be displayed before the text of the current tab.

Index Int32

Gets the zero based index of the item.

IsBreak Boolean

Gets or sets a value indicating whether next tab will be displayed on a new line.

Remarks

Use the IsBreak property to create multi-row tabstrip. All tabs after the "break" tab will be displayed on a new line.

IsSeparator Boolean

Gets or sets a value indicating whether the tab will behave as separator.

Remarks

Use separators to visually separate the tabs. You also need to specify the width of the separator tab through the Width property.

Level Int32

Gets the level of the current tab.

Gets or sets the URL to navigate to when the current tab is clicked.

Remarks

By default clicking a tab will select it. If the tab has any child tabs they will be displayed. To make a tab navigate to some designated URL you can use the NavigateUrl property. You can optionally set the Target property to specify the window or frame in which to display the linked content.

                   Setting the NavigateUrl property will disable tab selection and as a result the
                   TabClick event won't be raised for the current tab.

OuterCssClass String

Gets or sets the Cascading Style Sheet (CSS) class applied on the outmost tab element (

  • ).

    Remarks

    You can use the OuterCssClass property to specify unique appearance for the tab, or to insert elements that are before/after the link element.

    Owner IRadTabContainer

    Gets the IRadTabContainer instance which contains the current tab.

    Remarks

    The value is of the IRadTabContainer type which is implemented by the RadTabStrip class and the RadTab class. Use the Owner property when recursively traversing tabs in the RadTabStrip control.

    PageView RadPageView

    Gets the RadPageView activated when the tab is selected.

    PageViewID String

    Gets or sets the ID of the RadPageView in a RadMultiPage that will be switched when the tab is selected.

    Remarks

    This property overrides the default relation between the page views within a RadMultiPage and the tabs in a RadTabStrip. By default a tab activates the page view with the same index.

    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.

    PostBack Boolean

    Gets or sets a value indicating whether clicking on the tab will postback.

    Remarks

    If you subscribe to the TabClick event all tabs will postback. To prevent the current tab from initiating postback you can set the PostBack property to false.

    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 children of the tab will be scrollable.

    Remarks

    To enable scrolling of the child tabs the ScrollChildren property must also be set to true.

    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.

    Selected Boolean

    Gets or sets a value indicating whether the tab is selected.

    Remarks

    Use the Selected property to determine whether the tab is currently selected within its parent RadTabCollection. Setting the Selected property to true will deselect the previously selected tab.

    SelectedCssClass Boolean

    Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is selected.

    Remarks

    By default the visual appearance of selected tabs is defined in the skin CSS file. You can use the SelectedCssClass property to specify unique appearance for the current tab when it is selected.

    SelectedImageUrl Boolean

    Gets or sets the URL to an image which is displayed when the tab is selected.

    Remarks

    Use the SelectedImageUrl property to specify a custom image that will be displayed when the current tab is selected. Setting the SelectedImageUrl property required the ImageUrl property to be set beforehand.

                       If the SelectedImageUrl property is not set the value of the ImageUrl
                       will be used instead.
    

    SelectedIndex Boolean

    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 Boolean

    Gets the selected child tab.

    Tabs RadTabCollection

    Gets a RadTabCollection object that contains the child tabs of the current tab.

    Remarks

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

    TabStrip RadTabStrip

    Gets the RadTabStrip instance which contains the current tab.

    TabTemplate ITemplate

    Gets or sets the template for displaying the tab.

    Target String

    Gets or sets the target window or frame in which to display the Web page content associated with the current tab.

    Remarks

    Use the Target property to target window or frame in which to display the Web page content associated with the current tab. The Web page is specified by the NavigateUrl property.

                       If this property is not set, the Web page specified by the
                       NavigateUrl property is loaded in the current window.
                   
                       The Target property is taken into consideration only when the NavigateUrl
                       property is set.
    

    Text String

    Gets or sets the text displayed for the current tab.

    Remarks

    Use the Text property to specify or determine the text that is displayed for the tab in the RadTabStrip control.

    Value String

    Gets or sets custom (user-defined) data associated with the current tab.

    Remarks

    Use the Value property to associate custom data with a RadTab object.

    Methods

    IsChildControl

    Returns true if the control is rendered by the ControlItem itself; false if it was added by the user to the Controls collection.

    Returns

    System.Boolean

    RenderEndTag

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

    Parameters

    writer System.Web.UI.HtmlTextWriter

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

    Returns

    System.Void

    SelectParents

    Selects recursively all parent tabs in the hierarchy.

    Remarks

    Use this method to programmatically select all parents of the tab. Selected tabs will be visible in the browser.

    Returns

    System.Void