A newer version of this page is available. Switch to the current version.

RibbonStatusBar Class

The status bar designed to be used along with the RibbonControl.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

[ToolboxBitmap(typeof(ToolboxIconsRootNS), "RibbonStatusBar")]
public class RibbonStatusBar :
    ControlBase,
    ICustomBarControl,
    IBarObject,
    ISupportXtraAnimation,
    IToolTipControlClient,
    IEditorBackgroundProvider
<ToolboxBitmap(GetType(ToolboxIconsRootNS), "RibbonStatusBar")>
Public Class RibbonStatusBar
    Inherits ControlBase
    Implements ICustomBarControl,
               IBarObject,
               ISupportXtraAnimation,
               IToolTipControlClient,
               IEditorBackgroundProvider

Related API Members

The following members accept/return RibbonStatusBar objects:

Library Related API Members
WinForms Controls PrintPreviewRibbonFormEx.RibbonStatusBar
RibbonControl.StatusBar
RibbonControllerBase.RibbonStatusBar
RibbonForm.StatusBar
RibbonHitInfo.StatusBar
Reporting XRDesignRibbonForm.RibbonStatusBar
XRDesignRibbonFormEx.RibbonStatusBar

Remarks

A status bar is displayed at the bottom of a parent window (form). It is typically used to display various kinds of status information. It provides helpful feedback to end-users. A sample status bar is shown in the image below:

RibbonStatusBar

The collection of item links that are owned by the status bar can be accessed via the RibbonStatusBar.ItemLinks property. This collection provides methods that can be used to add, delete, access individual link objects and perform other common collection management tasks. To customize the status bar at design time, run the Designer and switch to the StatusBar page.

A status bar can display the size grip, which allows an end-user to resize the window by dragging the status bar's bottom right corner. The visibility of the size grip is controlled by the RibbonStatusBar.ShowSizeGrip property.

NOTE

The RibbonStatusBar must be associated with a RibbonControl. When you drop a RibbonStatusBar onto the form, at design time, it is automatically linked to an existing RibbonControl via the RibbonStatusBar.Ribbon property. When you create a RibbonStatusBar at runtime, you need to manually set the RibbonStatusBar.Ribbon property to an existing RibbonControl.

See Also