Click or drag to resize
RadTabControl Class
A navigation control used to create tabbed interface.
Inheritance Hierarchy
SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsControl
              System.Windows.ControlsItemsControl
                System.Windows.Controls.PrimitivesSelector
                  System.Windows.Controls.PrimitivesMultiSelector
                    Telerik.Windows.Controls.TabControlRadTabControlBase
                      Telerik.Windows.ControlsRadTabControl
                        Telerik.Windows.Controls.DockingPaneGroupBase
                        Telerik.Windows.Controls.FileDialogsFileBrowserTabControl
                        Telerik.Windows.ControlsRadOutlookBar
                        Telerik.Windows.ControlsRadRibbonBackstage

Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Navigation (in Telerik.Windows.Controls.Navigation.dll) Version: 2017.3.913.40 (2017.3.913.40)
Syntax
public class RadTabControl : RadTabControlBase, 
	IThemable

The RadTabControl type exposes the following members.

Constructors
  NameDescription
Public methodRadTabControl
Initializes a new instance of the RadTabControl class.
Top
Methods
  NameDescription
Protected methodChangeVisualState
Updates the visual states of the control.
(Overrides RadTabControlBaseChangeVisualState(Boolean).)
Protected methodClearContainerForItemOverride
When overridden in a derived class, undoes the effects of the PrepareContainerForItemOverride(DependencyObject, Object) method.
(Overrides SelectorClearContainerForItemOverride(DependencyObject, Object).)
Protected methodClearContentSafely
Clears all ContentPresenter elements inside the ContentElementStorage template part and clears the ContentElement template part. Also clears the ContentElementStorage children used to represent content from different tab items.
(Inherited from RadTabControlBase.)
Protected methodFindTemplateFromPosition Obsolete.
Returns a template for the given position of the tab strip.
Protected methodGetContainer
Returns a new instance of the control that implements the IRadTabItem interface.
(Overrides RadTabControlBaseGetContainer.)
Protected methodGetContainerForItemOverride
Creates the element that is used to display the given item.
(Inherited from RadTabControlBase.)
Protected methodGoToState
Attempts to move the control to one of the states in the list.
(Inherited from RadTabControlBase.)
Protected methodIsItemItsOwnContainerOverride
Determines if the specified item is (or is eligible to be) its own container.
(Inherited from RadTabControlBase.)
Public methodOnApplyTemplate
When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate.
(Overrides FrameworkElementOnApplyTemplate.)
Protected methodOnCreateAutomationPeer
Creates a RadTabControlAutomationPeer peer associated with this object.
(Overrides UIElementOnCreateAutomationPeer.)
Protected methodOnDropDownMenuItemClick Obsolete.
Called when a DropDownMenu menu item has been clicked.
Protected methodOnInitialized
Raises the Initialized event. This method is invoked whenever IsInitialized is set to true internally.
(Overrides SelectorOnInitialized(EventArgs).)
Protected methodOnIsDropDownOpenChanged Obsolete.
Called when the IsDropDownOpen property changes.
Protected methodOnItemsChanged
Invoked when the Items property changes.
(Overrides SelectorOnItemsChanged(NotifyCollectionChangedEventArgs).)
Protected methodOnItemsPanelChanged
Invoked when the ItemsPanel property changes.
(Overrides ItemsControlOnItemsPanelChanged(ItemsPanelTemplate, ItemsPanelTemplate).)
Protected methodOnLeftScrollButtonClick Obsolete.
Invoked when the left scroll button has been clicked.
Protected methodOnPreviewSelectionChanged
Raises the PreviewSelectionChangedEvent.
(Inherited from RadTabControlBase.)
Protected methodOnRightScrollButtonClick Obsolete.
Invoked when the right scroll button has been clicked.
Protected methodOnSelectionChanged
Raises the SelectionChanged routed event.
(Inherited from RadTabControlBase.)
Protected methodPrepareContainerForItemOverride
Prepares the specified element to display the specified item.
(Overrides SelectorPrepareContainerForItemOverride(DependencyObject, Object).)
Public methodScrollIntoView
Scrolls the container of given item into view.
Protected methodSelector_SelectionChanged
Handles the SelectionChanged event of the Selector control.
(Inherited from RadTabControlBase.)
Protected methodSetTemplate Obsolete.
Sets the control template to the given value.
Protected methodUpdateFocusOnSelectionChange
Updates the focus. This method should be called after selection of tab item in order to focus the appropriate element. If the focus is outside the tab or in the contents of the previously selected tab item then the first element in the selected tab contents will be focused. If the TabStrip is focused calling this method will focus the newly selected tab header.
(Inherited from RadTabControlBase.)
Protected methodUpdateSelectedContentProperties
Updates the selected content properties SelectedContent, SelectedContentTemplate and SelectedContentTemplateSelector. Selected content properties are used when representing the content of selected tab item.
(Overrides RadTabControlBaseUpdateSelectedContentProperties.)
Protected methodUpdateTabRows
Visually updates the tab rows.
(Inherited from RadTabControlBase.)
Protected methodUpdateTabStrip Obsolete.
Updates the tab strip.
Top
Extension Methods
  NameDescription
Public Extension MethodChildrenOfTypeT
Gets all child elements recursively from the visual tree by given type.
(Defined by ChildrenOfTypeExtensions.)
Public Extension MethodClearIfNoBindingAndSet
Clears if set.
(Defined by CommonExtensions.)
Public Extension MethodClearIfSet
Clears the property if a value has been set.
(Defined by CommonExtensions.)
Public Extension MethodDeserializePrimitives
Deserializes some primitive properties of a control.
(Defined by SerializationExtensions.)
Public Extension MethodEnableLayoutRounding (Defined by LayoutRoundingHelperExtensions.)
Public Extension MethodFindChildByTypeT
Finds child element of the specified type. Uses breadth-first search.
(Defined by ChildrenOfTypeExtensions.)
Public Extension MethodGetAssociatedInlineUIContainer (Defined by ExtensionMethods.)
Public Extension MethodGetAssociatedLayoutBox (Defined by ExtensionMethods.)
Public Extension MethodGetBaseControlItemStatus
Gets a string that communicates the visual status of a Control.
(Defined by AutomationExtensions.)
Public Extension MethodGetBoundsRelativeTo
Gets the bounds relative to the current framework element.
(Defined by ExtensionMethods.)
Public Extension MethodGetGlobalMousePosition
(Defined by WindowHost.)
Public Extension MethodGetParents
Enumerates through element's parents in the visual tree.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodGetVisualParentT
Searches up in the visual tree for parent element of the specified type.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodIsAncestorOf(DependencyObject)Overloaded.
Determines whether the element is ancestor of the current UI element.
(Defined by ExtensionMethods.)
Public Extension MethodIsAncestorOf(DependencyObject)Overloaded.
Determines whether the element is an ancestor of the descendant.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodIsKeyboardFocusWithin
Determines whether keyboard focus is within the current UI element.
(Defined by KeyboardHelper.)
Public Extension MethodIsLocalValueSet(DependencyProperty)Overloaded.
Determines whether the specified dependency property local value is set.
(Defined by DependencyObjectExtensions.)
Public Extension MethodIsLocalValueSet(DependencyProperty)Overloaded.
Determines whether the specified dependency property local value is set.
(Defined by CommonExtensions.)
Public Extension MethodParentOfTypeT
Gets the parent element from the visual tree by given type.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodSerializePrimitives
Serializes some primitive properties of a control.
(Defined by SerializationExtensions.)
Public Extension MethodSetAssociatedLayoutBox (Defined by ExtensionMethods.)
Public Extension MethodSetIfDifferent
Sets the value of the dependencyProperty property if it's hasn't that value currently.
(Defined by CommonExtensions.)
Public Extension MethodSetLayout
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSetLocation(Point)Overloaded.
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSetLocation(Double, Double)Overloaded.
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSlideInOverloaded.
Slides the given element into view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideIn(TimeSpan)Overloaded.
Slides the given element into view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideOutOverloaded.
Slides the given element out of view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideOut(TimeSpan)Overloaded.
Slides the given element out of view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodTranslate(NullableDouble, NullableDouble, NullableDouble, NullableDouble, TimeSpan)Overloaded.
Translates the target element as requested by the parameters.
(Defined by CalendarAnimation.)
Public Extension MethodTranslate(NullableDouble, NullableDouble, NullableDouble, NullableDouble, TimeSpan, Action)Overloaded.
Translates the target element as requested by the parameters and executes the action request.
(Defined by CalendarAnimation.)
Top
Fields
  NameDescription
Public fieldStatic memberAdditionalContentProperty
Identifies the AdditionalContent property.
Public fieldStatic memberAlignProperty
Identifies the Align property.
Public fieldStatic memberAllowDragOverTabProperty
Identifies the AllowDragOverTab property.
Public fieldStatic memberAllowDragReorderProperty
Identifies the AllowDragReorder property.
Public fieldStatic memberAllTabsEqualHeightProperty
Identifies the AllTabsEqualHeight property.
Public fieldStatic memberBottomTemplateProperty
Identifies the BottomTemplate property.
Public fieldStatic memberDropDownButtonStyleProperty
Identifies the DropDownButtonStyle property.
Public fieldStatic memberDropDownDisplayMemberPathProperty
Identifies the DropDownDisplayMemberPath property.
Public fieldStatic memberDropDownDisplayModeProperty
Identifies the DropDownDisplayMode property.
Public fieldStatic memberDropDownStyleProperty
Identifies the DropDownStyle property.
Public fieldStatic memberIsDropDownOpenProperty
Identifies the IsDropDownOpen property.
Public fieldStatic memberItemDropDownContentTemplateProperty
Identifies the ItemDropDownContentTemplate property.
Public fieldStatic memberItemDropDownContentTemplateSelectorProperty
Identifies the ItemDropDownContentTemplateSelector property.
Public fieldStatic memberItemReorderedEvent
Identifies the ItemReordered routed event.
Public fieldStatic memberLeftTemplateProperty
Identifies the LeftTemplate property.
Public fieldStatic memberOverflowModeProperty
Identifies the OverflowModeProperty property.
Public fieldStatic memberRightTemplateProperty
Identifies the RightTemplate property.
Public fieldStatic memberScrollModeProperty
Identifies the ScrollModeProperty property.
Public fieldStatic memberTabOrientationProperty
Identifies the TabOrientation property.
Public fieldStatic memberTabStripPlacementProperty
Identifies the TabStripPlacement property.
Public fieldStatic memberTopTemplateProperty
Identifies the TopTemplate property.
Top
Properties
  NameDescription
Public propertyAdditionalContent
Identifies the AdditionalContent property.
Public propertyAlign
Gets or sets the alignment of the tab items in the row - Left, Right, Center, Justify. This is a dependency property.
Public propertyAllowDragOverTab
Gets or sets a value indicating whether dragging objects over a tab item will select this TabItem. This is a dependency property.
Public propertyAllowDragReorder
Gets or sets a value indicating whether the user will be able to rearrange the tabs with dragging. This is a dependency property.
Public propertyAllTabsEqualHeight
Gets or sets whether all displayed tabs have equal height. This is a dependency property.
Public propertyBackgroundVisibility
Gets or sets the visibility of the background panel for the headers in the tab control. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertyBottomTemplate
Gets or sets the template of the tab control when the TabStripPlacement is set to Bottom. This is a dependency property.
Protected propertyContentElement
The ContentElement template part.
(Inherited from RadTabControlBase.)
Protected propertyContentElementsPanel
The ContentElementsPanel template part.
(Inherited from RadTabControlBase.)
Public propertyContentTemplate
Gets or sets the DataTemplate that will be used as a content template for all items that do not have a ContentTemplate. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertyContentTemplateSelector
Gets or sets the DataTemplateSelector that will be used to select a data template for the items that do not have a ContentTemplate set. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertyDropDownButtonStyle
Gets or sets the style for the DropDownMenu toggle button in the ControlTemplate of the tab control. This is a dependency property.
Public propertyDropDownDisplayMemberPath
Gets or sets the name of property that will be used to display tab items in the DropDownMenu. This is a dependency property.
Public propertyDropDownDisplayMode
Gets or sets when the DropDownMenu button should be displayed: always, never, when needed. This is a dependency property.
Public propertyDropDownStyle
Gets or sets the style for the DropDownMenu of the tab control. This is a dependency property.
Public propertyHeaderBackground
Gets or sets the background of the tab strip. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertyIsContentPreserved
Gets or sets a value indicating whether the state of the content will be preserved when selection is changed.
(Inherited from RadTabControlBase.)
Public propertyIsDefaultItemSelected
Gets or sets a value indicating whether the first tab item will be selected by default on start up.
(Inherited from RadTabControlBase.)
Public propertyIsDropDownOpen
Gets or sets a value indicating whether the DropDownMenu of the tab control is open. This is a dependency property.
Public propertyItem
Indexer, gets the tab item with the given index in the items collection.
(Inherited from RadTabControlBase.)
Public propertyItemDropDownContentTemplate
Gets or sets the DataTemplate that will be used to display the items in the drop down menu if they do not have a ItemDropDownContentTemplateSelector. This is a dependency property.
Public propertyItemDropDownContentTemplateSelector
Gets or sets the DataTemplateSelector that will be used to display the items in the drop down menu if they do not have a ItemDropDownContentTemplate. This is a dependency property.
Public propertyLeftTemplate
Gets or sets the template of the tab control when the TabStripPlacement is set to Left. This is a dependency property.
Public propertyOverflowMode
Gets or sets what happens when the width of the tab items exceeds the available width. They will either scroll or wrap.
Public propertyPropagateItemDataContextToContent
Gets or sets a value indication whether the data context of the tab item should be assigned as DataContext of the content area when the selection changes. The default is true.
(Inherited from RadTabControlBase.)
Public propertyReorderTabRows
Gets or sets whether the tab item rows would be reordered when selected. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertyRightTemplate
Gets or sets the template of the tab control when the TabStripPlacement is set to Right. This is a dependency property.
Public propertyScrollMode
Gets or sets the type of scrolling that will occur when the user presses the scroll buttons. This is a dependency property.
Public propertySelectedContent
Gets the content of the selected item. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertySelectedContentTemplate
Gets the content template of the currently selected item. Do not set this property because it is changed internally. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertySelectedContentTemplateSelector
Gets the DataTemplateSelector for the currently selected item. Do not set this property because it is changed internally. This is a dependency property.
(Inherited from RadTabControlBase.)
Public propertySelectedItemRemoveBehaviour
Determines what item should be selected when SelectedItem is removed.
(Inherited from RadTabControlBase.)
Public propertySelectedItems
SelectedItems property is not supported by this control.
(Inherited from RadTabControlBase.)
Public propertySupressSelectedContentTemplateReapplying
Gets or sets a value indicating whether the ContentPresenter rendering the tab items must refresh its data template on selection change. This property must be use in case when visual objects are used in the view model child collection bound to the tab control.
(Inherited from RadTabControlBase.)
Protected propertyTabFlags
Gets the flags.
(Inherited from RadTabControlBase.)
Public propertyTabOrientation
Gets or sets the orientation of the TabItems in the TabControl. This is a dependency property.
Protected propertyTabStrip
Gets or sets the tab strip. The tab strip visually represents the headers of tab items.
(Inherited from RadTabControlBase.)
Public propertyTabStripPlacement
Gets or sets the position of the tab strip with regard to the content. This is a dependency property.
Public propertyTopTemplate
Gets or sets the template of the tab control when the TabStripPlacement is set to Top. This is a dependency property.
Top
Events
  NameDescription
Public eventDropDownClosed
An event that is raised when the DropDownMenu is closed. This is a RoutedEvent.
(Inherited from RadTabControlBase.)
Public eventDropDownOpened
An event that is raised when the DropDownMenu is opened. This is a RoutedEvent.
(Inherited from RadTabControlBase.)
Public eventItemReordered
Occurs when a item is reordered while dragging. This is a RoutedEvent.
Public eventPreviewSelectionChanged
The preview event for SelectionChanged event. Handling this event rollbacks the selection. This is a RoutedEvent.
(Inherited from RadTabControlBase.)
Public eventSelectionChanged
Occurs when a changed has been made to the selection. This is a RoutedEvent.
(Inherited from RadTabControlBase.)
Top
Remarks

The RadTabControl is used to create a list of tabs. It is ItemsControl and its default items are of type RadTabItem.

  • Customizable look through the theming mechanism.
  • Control over the position of the TabStrip relative to its content.
  • Ability to set the orientation of the items.
  • Multi-row TabStrips can be created by setting the IsBreak property of an item.
  • The align of the tab rows can be changed.
  • Any content can be placed in the TabItem headers such as icons, buttons and multiline text.
See Also