RibbonStatusBar Class
The status bar designed to be used along with the RibbonControl.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v18.1.dll
Declaration
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "RibbonStatusBar")]
[ToolboxTabName("DX.18.1: Navigation & Layout")]
public class RibbonStatusBar :
ControlBase,
ICustomBarControl,
IBarObject,
ISupportXtraAnimation,
IToolTipControlClient,
IEditorBackgroundProviderRelated 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:
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.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RibbonStatusBar 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.