RibbonStatusBarControl Class

A Ribbon UI status bar.

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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Ribbon, DevExpress.Wpf.Navigation

Declaration

C#
VB.NET

public class RibbonStatusBarControl :
    Control,
    IRibbonStatusBarControl,
    ILogicalChildrenContainer,
    IMultipleElementRegistratorSupport,
    IBarNameScopeSupport,
    IInputElement,
    IMergingSupport,
    IHierarchicalMergingSupport<RibbonStatusBarControl>

Public Class RibbonStatusBarControl
    Inherits Control
    Implements IRibbonStatusBarControl,
               ILogicalChildrenContainer,
               IMultipleElementRegistratorSupport,
               IBarNameScopeSupport,
               IInputElement,
               IMergingSupport,
               IHierarchicalMergingSupport(Of RibbonStatusBarControl)

The following members return RibbonStatusBarControl objects:

Remarks

A status bar is typically positioned at the bottom of a parent window, and it usually displays various kinds of status information, providing helpful feedback to end-users.

Commands, submenus, static text, editors and other in-ribbon elements are represented by bar items and bar item links.

To add elements to the RibbonStatusBarControl, use the RibbonStatusBarControl.LeftItems and/or RibbonStatusBarControl.RightItems collections.

To learn more, see Ribbon Status Bar.

Example

This example shows how to add commands to a RibbonStatusBarControl. The commands are added to the RibbonStatusBarControl.RightItems and RibbonStatusBarControl.LeftItems collections. So, they will be aligned to the bar’s right and left edges, respectively. RibbonControl_Ex

View Example

MainWindow.xaml

<dxr:RibbonStatusBarControl Grid.Row="2" Name="StatusBar" IsSizeGripVisible="True" Grid.ColumnSpan="2">
    <dxr:RibbonStatusBarControl.RightItems>
        <dxb:BarStaticItem Name="bFileName" ItemMinWidth="150" AutoSizeMode="Fill" Content="Binding"/>
    </dxr:RibbonStatusBarControl.RightItems>
    <dxr:RibbonStatusBarControl.LeftItems>
        <dxb:BarStaticItem Name="bPosInfo" ItemMinWidth="150"/>

    </dxr:RibbonStatusBarControl.LeftItems>
</dxr:RibbonStatusBarControl>

The following code snippets (auto-collected from DevExpress Examples) contain references to the RibbonStatusBarControl class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-add-a-horizontal-offset-to-the-ribboncontrol-page-headers-e4296/CS/RibbonSample/MainWindow.xaml#L59

</dxr:RibbonControl>
<dxr:RibbonStatusBarControl DockPanel.Dock="Bottom" Name="ribbonStatusBarControl1" />
<Grid Name="grid1" />

Reporting_how-to-remove-standard-bar-items-and-add-custom-ones-to-the-documentviewer-toolbar-e2974/CS/WpfApplication1/MainWindow.xaml#L246


<dxr:RibbonStatusBarControl Grid.Row="2">
    <dxr:RibbonStatusBarControl.LeftItemLinks>

Reporting_how-to-show-a-ribbon-preview-window-for-link-e4407/CS/RibbonPrintPreviewDemo/MainWindow.xaml#L246

<dxp:DocumentViewer x:Name="viewer" Grid.Row="1" />
<dxr:RibbonStatusBarControl Grid.Row="2">
    <dxr:RibbonStatusBarControl.LeftItemLinks>

wpf-docklayoutmanager-merge-ribbon-controls/CS/WpfApplication1/MainWindow.xaml#L24

</dxr:RibbonControl>
<dxr:RibbonStatusBarControl DockPanel.Dock="Bottom" MDIMergeStyle="Always">
    <dxr:RibbonStatusBarControl.LeftItems>

how-to-handle-the-hyperlink-click-event-to-invoke-the-custom-form-t488029/CS/DXRichEditHyperlinkHandling/MainWindow.xaml#L835

</dxr:RibbonControl>
<dxr:RibbonStatusBarControl DockPanel.Dock="Bottom" HorizontalAlignment="Stretch" VerticalAlignment="Bottom">
    <dxr:RibbonStatusBarControl.RightItems>