Back to Devexpress

BackstageViewControl Class

wpf-devexpress-dot-xpf-dot-ribbon-1d8c2b3e.md

latest6.7 KB
Original Source

BackstageViewControl Class

The MS Office style full-screen menu.

Namespace : DevExpress.Xpf.Ribbon

Assembly : DevExpress.Xpf.Ribbon.v25.2.dll

NuGet Package : DevExpress.Wpf.Ribbon

Declaration

csharp
[DXLicenseWpf]
public class BackstageViewControl :
    Control,
    IComplexLayout,
    IHierarchicalMergingSupport<BackstageViewControl>,
    IKeyTipNavigationOwner,
    INavigationOwner,
    IBarsNavigationSupport,
    IMutableNavigationOwner,
    IMutableNavigationSupport,
    IKeyTipNavigationRoot,
    IDisableNavigationTreeControl,
    IBarsNavigationCompatibility
vb
<DXLicenseWpf>
Public Class BackstageViewControl
    Inherits Control
    Implements IComplexLayout,
               IHierarchicalMergingSupport(Of BackstageViewControl),
               IKeyTipNavigationOwner,
               INavigationOwner,
               IBarsNavigationSupport,
               IMutableNavigationOwner,
               IMutableNavigationSupport,
               IKeyTipNavigationRoot,
               IDisableNavigationTreeControl,
               IBarsNavigationCompatibility

The following members return BackstageViewControl objects:

Remarks

When your application uses Ribbon Control, you can add one of the following application menus to your application:

  • The Application Menu is the Windows Explorer style popup menu.
  • The Backstage View is the MS Office style full-screen menu.

Run Demo: Ribbon UI

Create a Backstage View

The following code sample adds a Backstage View to a RibbonControl:

xaml
<dx:ThemedWindow ...
  xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
  xmlns:dxr="http://schemas.devexpress.com/winfx/2008/xaml/ribbon" >
  <dxr:RibbonControl RibbonStyle="Office2019">
    <dxr:RibbonControl.ApplicationMenu>
      <dxr:BackstageViewControl>
        <dxr:BackstageViewControl.Items>
          <dxr:BackstageButtonItem Content="New" Glyph="{dx:SvgImageSource Uri='pack://application:,,,/DevExpress.Images.v25.2;component/SvgImages/Actions/New.svg', Size='16,16'}"/>
          <dxr:BackstageButtonItem Content="Open"/>
          <dxr:BackstageSeparatorItem />
          <dxr:BackstageTabItem Content="Settings">
            <dxr:BackstageTabItem.ControlPane>
              <StackPanel Margin="10,5,0,0">
                <Label Content="Ribbon style:" FontSize="16" FontWeight="Bold"/>
                <RadioButton Content="Office 2007" />
                <RadioButton Content="Office 2010" />
                <RadioButton Content="Office 2019" />
              </StackPanel>
            </dxr:BackstageTabItem.ControlPane>
          </dxr:BackstageTabItem>
          <dxr:BackstageButtonItem Content="Close" Placement="Bottom"/>
        </dxr:BackstageViewControl.Items>
      </dxr:BackstageViewControl>
    </dxr:RibbonControl.ApplicationMenu>
  <!-- ... -->
  </dxr:RibbonControl>
  <!-- ... -->
</dx:ThemedWindow>

View Example: WPF Ribbon - Create a Backstage View

Backstage View Visual Structure

The Backstage View includes two areas:

NamePosition in the Backstage ViewDescription
Item areaAt the leftContains all backstage items.
Control pane areaAt the rightDisplays the selected tab item’s content.

Item Area’s Child Objects

A BackstageViewControl can contain the following child objects:

Access Child Tabs

You can use the read-only BackstageViewControl.Tabs list to access all the existing BackstageViewControl ‘s tab items.

Customize a Backstage View

PropertyDescription
BackgroundGlyphGets or sets the image displayed at the BackstageViewControl ‘s right bottom corner.
TabPaneMinWidthGets or sets the Item area pane ‘s minimum width.
RibbonStyleGets or sets the BackstageViewControl ‘s paint style.
BackgroundStyleGets or sets the BackstageViewControl ‘s background style.
CloseButtonVisibilityGets or sets whether the button that closes the control is visible.
IsFullScreenGets or sets whether the BackstageViewControl occupies the entire client area of the application window. This is a dependency property.

Tip

The Backstage View supports key tips navigation. Refer to the Key Tips topic for more information.

Inheritance

Object DispatcherObject DependencyObject Visual UIElement FrameworkElement Control BackstageViewControl

See Also

BackstageViewControl Members

DevExpress.Xpf.Ribbon Namespace