RibbonStatusBar Class
The status bar designed to be used along with the RibbonControl.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v18.2.dll
Declaration
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "RibbonStatusBar")]
public class RibbonStatusBar :
ControlBase,
ICustomBarControl,
IBarObject,
ISupportXtraAnimation,
IToolTipControlClient,
IEditorBackgroundProviderRelated API Members
The following members 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.