[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.FilteringUI
  [Expand]DevExpress.Xpf.Core.Native
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Native
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gantt
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Collapse]DevExpress.Xpf.Ribbon
   [Expand]ApplicationMenu Class
   [Expand]ApplicationMenuInfo Class
   [Expand]BackstageButtonItem Class
   [Expand]BackstageItem Class
   [Expand]BackstageItemBase Class
   [Expand]BackstageSeparatorItem Class
   [Collapse]BackstageTabItem Class
     BackstageTabItem Members
     BackstageTabItem Constructor
    [Expand]BackstageTabItem Properties
    [Expand]BackstageTabItem Methods
   [Expand]BackstageViewControl Class
    BackstageViewPlacement Enumeration
   [Expand]BarButtonGroup Class
   [Expand]BarButtonGroupLink Class
   [Expand]DropDownGalleryEventArgs Class
    DropDownGalleryEventHandler Delegate
   [Expand]DXRibbonWindow Class
   [Expand]GalleryDropDownPopupMenu Class
    MinimizationButtonPosition Enumeration
   [Expand]RibbonControl Class
   [Expand]RibbonDefaultPageCategory Class
   [Expand]RibbonGalleryBarItem Class
   [Expand]RibbonGalleryBarItemLink Class
    RibbonMergeType Enumeration
    RibbonMinimizationButtonVisibility Enumeration
   [Expand]RibbonPage Class
   [Expand]RibbonPageCategory Class
   [Expand]RibbonPageCategoryBase Class
    RibbonPageCategoryCaptionAlignment Enumeration
   [Expand]RibbonPageGroup Class
    RibbonQuickAccessToolbarShowMode Enumeration
   [Expand]RibbonStatusBarControl Class
    RibbonStyle Enumeration
    RibbonTitleBarVisibility Enumeration
    SelectedPageOnCategoryShowing Enumeration
    SelectedPageOnMerging Enumeration
    SimplifiedModeLocation Enumeration
   [Expand]SimplifiedModeSettings Class
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Common
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.iCalendar
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

BackstageTabItem Class

A tab item within a BackstageViewControl.

Namespace:DevExpress.Xpf.Ribbon
Assembly:DevExpress.Xpf.Ribbon.v19.2.dll

Expanded Syntax

Expanded Remarks

A tab item is a clickable element within a BackstageViewControl, structurally consisting of the content and control pane areas. The following figure illustrates a visual tab item's areas allocation:

Backstage item content, specified by the BackstageItem.Content property, is displayed at the BackstageViewControl's left edge. To set a custom width for this area, use the BackstageViewControl.TabPaneMinWidth property. This area's style settings can be customized via the BackstageViewControl.TabPaneStyle property.

The control pane is displayed when the tab item is selected. This area displays the ControlPane container. The ControlPane property can be initialized with a single object only. To display multiple controls within the control pane, add desired controls to a container (such as Grid or StackPanel) and initialize the ControlPane property with this container.

You can add a tab item by inserting a BackstageTabItem new instance in the BackstageViewControl's Items collection. In XAML, define a BackstageTabItem object between the BackstageViewControl opening and closing tags. See the example to learn more.

All existing tab items within a BackstageViewControl can be accessed via the BackstageViewControl.Tabs collection. Their total count is specified by the BackstageViewControl.TabCount property. You can access an individual tab item using the BackstageViewControl.Tabs collection or the BackstageViewControl.GetTabFromIndex method. To get a tab item's index, use the BackstageViewControl.GetTabIndex method.

One of the tab items in a BackstageViewControl is always selected, which means its IsSelected property is set to true. This ensures that the control pane area always displays some content. The currently selected tab can also be accessed through the BackstageViewControl.SelectedTabIndex or BackstageViewControl.SelectedTab property. These properties also allow selecting a tab item. Refer to these links to learn more about how it works.

Expanded Example

Imagine you want to create a BackstageViewControl with a button, a tab item and a separator item between them, as seen in the following figure:

To add these items via a XAML markup, define new BackstageButtonItem, BackstageTabItem and BackstageSeparatorItem class objects between the opening and closing tags of a BackstageViewControl. When an end-user selects the tab item, a label and two radio buttons should be displayed at the right of BackstageViewControl. To add multiple items as a tab item's content, define a container, place these items inside of it and initialize the ControlPane property with this container. In this example, a Grid container is used. The button item's BackstageItemBase.Click event is used to respond to an end-user clicking this button.

Expanded Inheritance Hierarchy

System.Object
    System.Windows.Threading.DispatcherObject
       System.Windows.DependencyObject
          System.Windows.Media.Visual
             System.Windows.UIElement
                System.Windows.FrameworkElement
                   System.Windows.Controls.Control
                      BackstageItemBase
                         BackstageItem
                            BackstageTabItem

Expanded See Also

Is this topic helpful?​​​​​​​