Back to all docs
API Reference / Telerik.Windows.Controls / RadTabbedWindow
New to Telerik UI for WPF? Start a free 30-day trial

RadTabbedWindow

Class

A Window component which hosts RadTabControl and simulates browser behavior. Tabs can be selected, pinned, unpinned, closed, reordered.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:
C#
[TelerikToolboxCategory("Navigation")]
public class RadTabbedWindow : RadWindow, INotifyLayoutChange, IDragAware

Inheritance: objectWindowBaseRadWindowRadTabbedWindow

Implements: IDragAwareINotifyLayoutChange

Inherited Members RadWindow.ResponseButtonPropertyRadWindow.IconPropertyRadWindow.IconMarginPropertyRadWindow.IconTemplatePropertyRadWindow.WindowStartupLocationPropertyRadWindow.DialogResultPropertyRadWindow.PromptResultPropertyRadWindow.BorderBackgroundPropertyRadWindow.RestoreMinimizedLocationPropertyRadWindow.IsRestrictedPropertyRadWindow.RestrictedAreaMarginPropertyRadWindow.IsRestrictedWhenMaximizedPropertyRadWindow.ShouldUpdateActiveStatePropertyRadWindow.GetParentRadWindow(DependencyObject)RadWindow.GetResponseButton(DependencyObject)RadWindow.SetResponseButton(DependencyObject, ResponseButton)RadWindow.Show()RadWindow.ShowDialog()RadWindow.ShouldFocusOnActivate()RadWindow.ChangeVisualState(bool)RadWindow.OnPreviewClosed(WindowPreviewClosedEventArgs)RadWindow.OnClosed(WindowClosedEventArgs)RadWindow.OnHostCreated(HostWindowCreatedEventArgs)RadWindow.OnGotFocus(RoutedEventArgs)RadWindow.OnLostFocus(RoutedEventArgs)RadWindow.OnKeyDown(KeyEventArgs)RadWindow.OnClosing()RadWindow.OnPreviewClosed()RadWindow.GetWindowOwner()RadWindow.GetWindowStartupLocation()RadWindow.OnClosed()RadWindow.Alert(object)RadWindow.Alert(object, EventHandler<WindowClosedEventArgs>)RadWindow.Alert(DialogParameters)RadWindow.Prompt(object, EventHandler<WindowClosedEventArgs>)RadWindow.Prompt(object, EventHandler<WindowClosedEventArgs>, string)RadWindow.Prompt(DialogParameters)RadWindow.Confirm(DialogParameters)RadWindow.Confirm(object, EventHandler<WindowClosedEventArgs>)RadWindow.ConfigureModal(RadAlert, DialogParameters)RadWindow.DefaultSizeRatioRadWindow.BorderBackgroundRadWindow.IconTemplateRadWindow.IconRadWindow.IconMarginRadWindow.WindowStartupLocationRadWindow.DialogResultRadWindow.PromptResultRadWindow.RestoreMinimizedLocationRadWindow.IsRestrictedRadWindow.RestrictedAreaMarginRadWindow.IsRestrictedWhenMaximizedRadWindow.ShouldUpdateActiveStateRadWindow.ClosedRadWindow.PreviewClosedRadWindow.HostCreatedWindowBase.IsModalPropertyWindowBase.IsOpenPropertyWindowBase.IsResizingPropertyWindowBase.IsDraggingPropertyWindowBase.IsActiveWindowPropertyWindowBase.IsInActiveStatePropertyWindowBase.IsTopmostPropertyWindowBase.CaptionHeightPropertyWindowBase.ResizeBorderPropertyWindowBase.LeftPropertyWindowBase.TopPropertyWindowBase.WindowStatePropertyWindowBase.ResizeModePropertyWindowBase.CanClosePropertyWindowBase.CanMovePropertyWindowBase.SizeToContentPropertyWindowBase.HideMinimizeButtonPropertyWindowBase.HideMaximizeButtonPropertyWindowBase.CornerRadiusPropertyWindowBase.Close()WindowBase.GetZIndex()WindowBase.BringToFront()WindowBase.GetNormalSizeAndPosition()WindowBase.ShouldActivateOnShow()WindowBase.ShouldShowInTaskSwitcher()WindowBase.ShouldActivate()WindowBase.ChangeVisualState()WindowBase.ShowWindow(bool)WindowBase.CheckCanClose()WindowBase.OnLayoutChangeEnded(EventArgs)WindowBase.OnLocationChanged(EventArgs)WindowBase.OnLayoutChangeStarted(EventArgs)WindowBase.OnGotKeyboardFocus(KeyboardFocusChangedEventArgs)WindowBase.GetApplicationSize()WindowBase.OnLayoutChangeEnded()WindowBase.OnLayoutChangeStarted()WindowBase.CloseWithoutEventsAndAnimations()WindowBase.OnCloseAnimationFinished()WindowBase.OnShowAnimationFinished()WindowBase.OnRightMouseButtonUp()WindowBase.OnRootVisualSizeChanged()WindowBase.OnDragStart(Point, bool)WindowBase.OnDragEnd(Point, bool, bool)WindowBase.OnDragDelta(Point, Rect, Rect, bool)WindowBase.GetWindowOwnerHandle()WindowBase.OnActivated(EventArgs)WindowBase.OnDeactivated(EventArgs)WindowBase.ShouldSystemMenuOnRightClick()WindowBase.IsModalWindowBase.IsOpenWindowBase.IsTopmostWindowBase.CaptionHeightWindowBase.ResizeBorderWindowBase.LeftWindowBase.TopWindowBase.IsResizingWindowBase.IsDraggingWindowBase.IsLayoutChangingWindowBase.WindowStateWindowBase.ResizeModeWindowBase.CanCloseWindowBase.CanMoveWindowBase.IsActiveWindowWindowBase.IsInActiveStateWindowBase.CornerRadiusWindowBase.SizeToContentWindowBase.HideMaximizeButtonWindowBase.HideMinimizeButtonWindowBase.OwnerWindowBase.ActivatedWindowBase.DeactivatedWindowBase.LayoutChangeEndedWindowBase.LayoutChangeStartedWindowBase.LocationChangedWindowBase.WindowStateChanged...

Constructors

RadTabbedWindow()

Initializes a new instance of the RadTabbedWindow class.

C#
public RadTabbedWindow()
Remarks:

Use this constructor to create an instance of the RadTabbedWindow. In order for the RadTabbedWindow to be displayed, it is not necessary to add it to the visual tree.

Fields

AddButtonStyleProperty

DependencyProperty

Identifies the AddButtonStyle property.

C#
public static readonly DependencyProperty AddButtonStyleProperty

AddButtonVisibilityProperty

DependencyProperty

Identifies the AddButtonVisibility dependency property.

C#
public static readonly DependencyProperty AddButtonVisibilityProperty

DisplayMemberPathProperty

DependencyProperty

Registers the DisplayMemberPath property.

C#
public static readonly DependencyProperty DisplayMemberPathProperty

DragDropModeProperty

DependencyProperty

Registers the DragDropMode property.

C#
public static readonly DependencyProperty DragDropModeProperty

IsContentPreservedProperty

DependencyProperty

Identifies the IsContentPreserved property.

C#
public static readonly DependencyProperty IsContentPreservedProperty

ItemContainerStyleProperty

DependencyProperty

Identifies the ItemContainerStyle dependency property.

C#
public static readonly DependencyProperty ItemContainerStyleProperty

ItemContainerStyleSelectorProperty

DependencyProperty

Identifies the ItemContainerStyleSelector dependency property.

C#
public static readonly DependencyProperty ItemContainerStyleSelectorProperty

ItemMinWidthProperty

DependencyProperty

Registers the ItemMinWidth property.

C#
public static readonly DependencyProperty ItemMinWidthProperty

ItemsPanelProperty

DependencyProperty

Identifies the ItemsPanel dependency property.

C#
public static readonly DependencyProperty ItemsPanelProperty

ItemsSourceProperty

DependencyProperty

Identifies the ItemsSource dependency property.

C#
public static readonly DependencyProperty ItemsSourceProperty

ItemTemplateProperty

DependencyProperty

Identifies the ItemTemplate dependency property.

C#
public static readonly DependencyProperty ItemTemplateProperty

ItemTemplateSelectorProperty

DependencyProperty

Identifies the ItemTemplateSelector dependency property.

C#
public static readonly DependencyProperty ItemTemplateSelectorProperty

ItemWidthProperty

DependencyProperty

Registers the ItemWidth property.

C#
public static readonly DependencyProperty ItemWidthProperty

ScrollModeProperty

DependencyProperty

Identifies the ScrollModeProperty property.

C#
public static readonly DependencyProperty ScrollModeProperty

SelectedIndexProperty

DependencyProperty

Identifies the SelectedIndex dependency property.

C#
public static readonly DependencyProperty SelectedIndexProperty

SelectedItemProperty

DependencyProperty

Identifies the SelectedItem dependency property.

C#
public static readonly DependencyProperty SelectedItemProperty

SelectedItemRemoveBehaviourProperty

DependencyProperty

Identifies the SelectedItemRemoveBehaviour property.

C#
public static readonly DependencyProperty SelectedItemRemoveBehaviourProperty

TabbedWindowCreatingEvent

RoutedEvent

Registers the TabbedWindowCreating routed event.

C#
public static readonly RoutedEvent TabbedWindowCreatingEvent

Properties

AddButtonStyle

Style

Gets or sets the style of the add tabs button.

C#
public Style AddButtonStyle { get; set; }

AddButtonVisibility

Visibility

Gets or sets the AddButtonVisibility.

C#
public Visibility AddButtonVisibility { get; set; }

DisplayMemberPath

Gets or sets the DisplayMemberPath of the TabControl.

C#
public string DisplayMemberPath { get; set; }

DragDropMode

Gets or sets a value indicating the current drag drop mode.

C#
public DragDropMode DragDropMode { get; set; }

IsContentPreserved

Gets or sets a value indicating whether the state of the content will be preserved when selection is changed.

C#
public bool IsContentPreserved { get; set; }
Property Value:

True if the first tab will preserve the content state; otherwise, false.

ItemContainerStyle

Style

Gets or sets the ItemContainerStyle of the TabControl.

C#
public Style ItemContainerStyle { get; set; }

ItemContainerStyleSelector

StyleSelector

Gets or sets the ItemContainerStyleSelector of the TabControl.

C#
public StyleSelector ItemContainerStyleSelector { get; set; }

ItemMinWidth

Gets or sets the minimum width of the tab items.

C#
public double ItemMinWidth { get; set; }

Items

Gets the Items of the inner RadTabControl. They can be populated either in XAML or in code.

C#
public IList Items { get; }

ItemsPanel

ItemsPanelTemplate

Gets or sets the ItemsPanel of the TabControl.

C#
public ItemsPanelTemplate ItemsPanel { get; set; }

ItemsSource

Gets or sets the ItemsSource of the TabControl.

C#
public IEnumerable ItemsSource { get; set; }

ItemTemplate

DataTemplate

Gets or sets the ItemTemplate of the TabControl.

C#
public DataTemplate ItemTemplate { get; set; }

ItemTemplateSelector

DataTemplateSelector

Gets or sets the ItemTemplateSelector of the TabControl.

C#
public DataTemplateSelector ItemTemplateSelector { get; set; }

ItemWidth

Gets or sets the default width of the tab items.

C#
public double ItemWidth { get; set; }

PinnedItems

Gets the collection of currently pinned RadTabItems.

C#
public ReadOnlyObservableCollection<RadTabItem> PinnedItems { get; }

ScrollMode

Gets or sets the type of scrolling that will occur when the user presses the scroll buttons.

C#
public TabControlScrollMode ScrollMode { get; set; }

SelectedIndex

Gets or sets the selected index of the TabControl.

C#
public int SelectedIndex { get; set; }

SelectedItem

Gets or sets the selected item of the TabControl.

C#
public object SelectedItem { get; set; }

SelectedItemRemoveBehaviour

Determines what item should be selected when SelectedItem is removed.

C#
public SelectedItemRemoveBehaviour SelectedItemRemoveBehaviour { get; set; }

Methods

OnApplyTemplate()

Invoked whenever application-specific logic is needed to apply the template for the current instance of the RadTabbedWindow.

C#
public override void OnApplyTemplate()

Overrides: RadWindow.OnApplyTemplate()

Remarks:

This method is called when the element is being templated and is used to apply visual tree changes and binding logic associated with the control's template.

OnCreateAutomationPeer()

AutomationPeer

Returns class-specific System.Windows.Automation.Peers.AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

Overrides: RadWindow.OnCreateAutomationPeer()

OnInitialized(EventArgs)

Raises the event and sets from the active theme.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Overrides: RadWindow.OnInitialized(EventArgs)

OnRenderSizeChanged(SizeChangedInfo)

Occurs when the render sized is changed.

C#
protected override void OnRenderSizeChanged(SizeChangedInfo sizeInfo)
Parameters:sizeInfoSizeChangedInfo

OnTabbedWindowCreating(TabbedWindowCreatingEventArgs)

Occurs when new RadTabbedWindow is created with drag drop operation.

C#
protected virtual bool OnTabbedWindowCreating(TabbedWindowCreatingEventArgs args)
Parameters:argsTabbedWindowCreatingEventArgsReturns:

bool

Returns True if user has not canceled the creation.

OnWindowStateChanged(EventArgs)

Occurs when WindowState is changed.

C#
protected override void OnWindowStateChanged(EventArgs args)
Parameters:argsEventArgs

Overrides: RadWindow.OnWindowStateChanged(EventArgs)

PrepareNewWindow()

Creates a new RadTabbedWindow host when a tab is dragged out of its parent window.

C#
protected virtual RadTabbedWindow PrepareNewWindow()
Returns:

RadTabbedWindow

Returns a new instance of RadTabbedWindow that serves as a host of the dragged out RadTabItem

ResetTheme()

Resets the theme.

C#
public void ResetTheme()

Events

AddingNewTab

Occurs when RadTabItem is being added via the 'Add' button in the UI.

C#
public event EventHandler<AddingNewTabEventArgs> AddingNewTab

ItemsChanged

Occurs when Items collection of RadTabItems is changed.

C#
public event NotifyCollectionChangedEventHandler ItemsChanged

PreviewSelectionChanged

The preview event for SelectionChanged event. Handling this event rollbacks the selection. This is a RoutedEvent.

C#
public event RadSelectionChangedEventHandler PreviewSelectionChanged

PreviewTabClosed

Occurs when a RadTabItem is about to be closed.

C#
public event EventHandler<PreviewTabChangedEventArgs> PreviewTabClosed

PreviewTabPinned

Occurs when a RadTabItem is about to be pinned.

C#
public event EventHandler<PreviewTabChangedEventArgs> PreviewTabPinned

PreviewTabUnpinned

Occurs when a RadTabItem is about to be unpinned.

C#
public event EventHandler<PreviewTabChangedEventArgs> PreviewTabUnpinned

SelectionChanged

Occurs when a changed has been made to the selection. This is a RoutedEvent.

C#
public event RadSelectionChangedEventHandler SelectionChanged

TabbedWindowCreating

Occurs when a new RadTabbedWindow is created via drag drop and is about to be shown.

C#
public event EventHandler<TabbedWindowCreatingEventArgs> TabbedWindowCreating

TabClosed

Occurs when a RadTabItem is closed.

C#
public event EventHandler<TabChangedEventArgs> TabClosed

TabPinned

Occurs when a RadTabItem is pinned.

C#
public event EventHandler<TabChangedEventArgs> TabPinned

TabUnpinned

Occurs when a RadTabItem is unpinned.

C#
public event EventHandler<TabChangedEventArgs> TabUnpinned
In this article
DefinitionConstructorsRadTabbedWindow()FieldsAddButtonStylePropertyAddButtonVisibilityPropertyDisplayMemberPathPropertyDragDropModePropertyIsContentPreservedPropertyItemContainerStylePropertyItemContainerStyleSelectorPropertyItemMinWidthPropertyItemsPanelPropertyItemsSourcePropertyItemTemplatePropertyItemTemplateSelectorPropertyItemWidthPropertyScrollModePropertySelectedIndexPropertySelectedItemPropertySelectedItemRemoveBehaviourPropertyTabbedWindowCreatingEventPropertiesAddButtonStyleAddButtonVisibilityDisplayMemberPathDragDropModeIsContentPreservedItemContainerStyleItemContainerStyleSelectorItemMinWidthItemsItemsPanelItemsSourceItemTemplateItemTemplateSelectorItemWidthPinnedItemsScrollModeSelectedIndexSelectedItemSelectedItemRemoveBehaviourMethodsOnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnRenderSizeChanged(SizeChangedInfo)OnTabbedWindowCreating(TabbedWindowCreatingEventArgs)OnWindowStateChanged(EventArgs)PrepareNewWindow()ResetTheme()EventsAddingNewTabItemsChangedPreviewSelectionChangedPreviewTabClosedPreviewTabPinnedPreviewTabUnpinnedSelectionChangedTabbedWindowCreatingTabClosedTabPinnedTabUnpinned
Not finding the help you need?
Contact Support