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.
NavigateUrl String
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