TabControl

Gets or sets the background of the add-new-tab button.

Gets or sets the colour of the plus sign on the add-new-tab button.

Gets or sets the tooltip shown over the add-new-tab button.

Gets or sets the colour of the arrow on the button that scrolls the tab strip back.

The scroll buttons are enabled only when there are tabs out of sight in their direction.

Gets or sets the colour of the outline of the arrow on the button that scrolls the tab strip back.

Gets or sets the colour of the arrow on the button that scrolls the tab strip on.

Gets or sets the colour of the outline of the arrow on the button that scrolls the tab strip on.

Gets or sets the colour of the cross on each tab's close button.

Under the pointer the cross takes TabItemCloseButtonFillOnMouseOverBrush instead.

Gets or sets the colour of the thin outline round the cross on each tab's close button.

Gets or sets the tooltip shown over each tab's close button.

Set it to text in the application's own language and terms – "Close document", "Close customer".

Gets or sets whether a "+" button is shown at the end of the tab strip for the user to open a new tab.

The button sits after the scroll buttons, is drawn with AddNewItemButtonBackground and AddNewItemContentBrush, shows AddNewTabItemTooltipText, and raises AddNewTabItemClick – handle that to add the tab.

Gets or sets the shape and style the tabs are drawn in.

It can be changed at any time, for example from a user preference, and the selected tab stays selected. Each mode works with every TabStripPlacement; on the left and right, the shaped modes draw their side-strip equivalent.

The classic modes are coloured by TabItemPathBrush, TabItemSelectedFill, TabItemFillOnMouseOverBrush and TabItemBorderOnMouseOverBrush; the modern modes by TabItemAccentBrush, TabItemAccentForeground and TabControlBackground.

<tabs:TabControl RenderingMode="Fluent" TabItemAccentBrush="#0F6CBD" TabStripPlacement="Left" />

Gets or sets the background of the two buttons that scroll the tab strip when the tabs do not fit.

A disabled scroll button – one with no more tabs to show in its direction – is drawn at 40% opacity.

Gets or sets the background of a scroll button while the pointer is over it.

Gets or sets the background of the page area, where the selected tab's content is shown.

The TabControlRenderingMode.Browser, TabControlRenderingMode.Card and TabControlRenderingMode.RoundedTop modes also fill the selected tab with it, so the tab and its page read as one piece.

Gets or sets the accent colour the modern rendering modes mark the selected tab with: the filled pill, the underline, the selection bar, the outline.

Used by TabControlRenderingMode.Pill, TabControlRenderingMode.Underline, TabControlRenderingMode.Fluent, TabControlRenderingMode.Backstage, TabControlRenderingMode.Outline, TabControlRenderingMode.Glass and TabControlRenderingMode.Minimal, and by the side-strip tabs. Usually the application's brand or accent colour.

Gets or sets the colour of text drawn on TabItemAccentBrush, such as the selected tab's header in the TabControlRenderingMode.Pill, TabControlRenderingMode.Backstage and TabControlRenderingMode.Glass modes.

Gets or sets the colour of the outline round the tabs and the page area.

Gets or sets the colour of the outline of a tab while the pointer is over it, in the classic rendering modes.

Gets or sets the colour of the cross on a tab's close button while the pointer is over it.

Gets or sets the template every tab is drawn with.

Set RenderingMode to TabControlRenderingMode.Custom and give this a template of your own, targeting TabItem, to draw tabs that none of the built-in modes offer. A template you set yourself takes precedence over the one the rendering mode chooses. Name a Button in it PART_TabItemCloseButton for the tab to have a working close button.

<tabs:TabControl RenderingMode="Custom">
    <tabs:TabControl.TabItemControlTemplate>
        <ControlTemplate TargetType="tabs:TabItem">
            <Border x:Name="Chrome" Padding="12,6" Background="Transparent">
                <StackPanel Orientation="Horizontal">
                    <ContentPresenter ContentSource="Header" VerticalAlignment="Center" />
                    <Button x:Name="PART_TabItemCloseButton" Content="x" Margin="8,0,0,0" Padding="4,0" />
                </StackPanel>
            </Border>
            <ControlTemplate.Triggers>
                <Trigger Property="IsSelected" Value="True">
                    <Setter TargetName="Chrome" Property="Background" Value="#DCE6F4" />
                </Trigger>
            </ControlTemplate.Triggers>
        </ControlTemplate>
    </tabs:TabControl.TabItemControlTemplate>
</tabs:TabControl>

Gets or sets the fill of a tab that is not selected while the pointer is over it, in the classic rendering modes.

Gets or sets the fill of the tabs that are not selected, in the classic rendering modes.

The fill of the tab's shape in TabControlRenderingMode.Default, TabControlRenderingMode.Trapezium, TabControlRenderingMode.RaisedTrapezium, TabControlRenderingMode.Diamond and the side-strip tabs. Under the pointer it gives way to TabItemFillOnMouseOverBrush, and on the selected tab to TabItemSelectedFill.

Gets or sets the fill of the selected tab in the classic rendering modes.

To make the selected tab look joined to its page, give it the same colour as TabControlBackground.

Gets or sets the colour of the tabs' header text.

Some modes override it for particular states – the selected tab in the accent-filled modes uses TabItemAccentForeground.

Gets or sets the colour behind the tab headers, including the scroll and add buttons.

Set it when the control sits on a dark or busy background: unselected tabs in the flat modes draw no fill of their own, so their text is read against what is behind the strip.

Asks for the selected tab to be closed when the user presses Ctrl+F4, as in other Windows applications, and otherwise handles the key as a tab control does.

Ctrl+F4 raises TabItem.CloseTabItemClick on the selected tab when it is a TabItem that is enabled and shows its close button; otherwise the key is passed on.

Occurs when the user clicks the "+" button at the end of the tab strip.

The button is shown while IsAddNewTabItemButtonVisible is on. The control does not add a tab itself: add a TabItem to ItemsControl.Items in the handler, or an item to the bound collection, and select it if the user should start on it.

A bubbling routed event, so a parent element can handle it for several tab controls.

documents.AddNewTabItemClick += (sender, e) =>
{
    TabItem page = new TabItem { Header = "New query", Content = new QueryEditor() };
    documents.Items.Add(page);
    documents.SelectedItem = page;
};

Identifies the AddNewItemButtonBackground dependency property.

Identifies the AddNewItemContentBrush dependency property.

Identifies the AddNewTabItemClick routed event.

Identifies the AddNewTabItemTooltipText dependency property.

Identifies the ButtonLeftArrowGeometryPathFillBrush dependency property.

Identifies the ButtonLeftArrowGeometryPathStrokeBrush dependency property.

Identifies the ButtonRightArrowGeometryPathFillBrush dependency property.

Identifies the ButtonRightArrowGeometryPathStrokeBrush dependency property.

Identifies the CloseButtonCrossMarkColorBrush dependency property.

Identifies the CloseButtonStrokeBrush dependency property.

Identifies the CloseTabTooltipText dependency property.

Identifies the IsAddNewTabItemButtonVisible dependency property.

Identifies the RenderingMode dependency property.

Identifies the ScrollButtonBrush dependency property.

Identifies the ScrollButtonOnMouseOverBrush dependency property.

Identifies the TabControlBackground dependency property.

Identifies the TabItemAccentBrush dependency property.

Identifies the TabItemAccentForeground dependency property.

Identifies the TabItemBorderBrush dependency property.

Identifies the TabItemBorderOnMouseOverBrush dependency property.

Identifies the TabItemCloseButtonFillOnMouseOverBrush dependency property.

Identifies the TabItemControlTemplate dependency property.

Identifies the TabItemFillOnMouseOverBrush dependency property.

Identifies the TabItemPathBrush dependency property.

Identifies the TabItemSelectedFill dependency property.

Identifies the TabItemTextForeground dependency property.

Identifies the TabStripBackground dependency property.