[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
   [Expand]BackstageTabItem Class
   [Collapse]BackstageViewControl Class
     BackstageViewControl Members
     BackstageViewControl Constructor
    [Expand]BackstageViewControl Properties
    [Expand]BackstageViewControl Events
    [Expand]BackstageViewControl Methods
    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)

BackstageViewControl Class

A popup menu emulating the menu in MS Office 2010 Ribbon UI.

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

Expanded Syntax

Expanded Remarks

The BackstageViewControl allows you to recreate a Microsoft Office 2010 application main menu. When displayed within a RibbonControl this menu stretches to fill an entire window (compared with the ApplicationMenu which is not automatically stretched). The image below illustrates a sample BackstageViewControl:

To link a BackstageViewControl with a RibbonControl, initialize the RibbonControl.ApplicationMenu property with a new BackstageViewControl object.

The BackstageViewControl allows you to use three types of items.

  • The BackstageButtonItem is a regular element, similar to a common button. Use the BackstageButtonItemto fulfill certain actions (like opening a file or closing an application) when the button is clicked. The BackstageButtonItem.Command property and BackstageItemBase.Click event allow you to implement an action.
  • The BackstageTabItem structurally consists of the content (caption) and control pane areas. Along with BackstageButtonItems, tab item contents are displayed at the BackstageViewControl's left edge. When an end-user selects a tab item, the tab item expands to the right and the control pane is displayed. To specify controls to be displayed in this area, use the BackstageTabItem.ControlPane property. Typically, control pane groups are controlled by a certain feature. For instance, 'Save' item in MS Word unites a set of controls that provide different options for saving a document. A 'Recent' tab item in the figure above combines four controls (links to recently opened files).
  • The BackstageSeparatorItem visually separates neighboring backstage items with a horizontal line.

The BackstageViewControl stores items in an Items collection. Use this collection to add new backstage items via code. To do it in a XAML markup, place a new instance of a backstage item's class between the opening and closing tags of BackstageViewControl. The Items collection is marked with the System.Windows.Markup.ContentPropertyAttribute for the BackstageViewControl. This means that you can add new backstage items to the Items collection in XAML by defining these objects between the opening and closing tags of the BackstageViewControl. The Tabs list allows you to access all existing tab items in a BackstageViewControl. Unlike an Items collection, the Tabs list is read-only, so it can't be modified via code and a XAML markup.

The BackstageViewControl can be customized in a many ways. For example, use the BackgroundGlyph property to set an image to be displayed at the BackstageViewControl's right bottom corner. You can manually set an area's width where item contents are displayed with the help of the TabPaneMinWidth property. A set of style members allows you to set general appearance settings for both the content and control pane areas.

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
                      BackstageViewControl

Expanded See Also

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