Statusbars
Statusbars, represented by the StatusBar class, provide a powerful alternative to the Windows Forms StatusBar class.
In addition to customizable rendering, the Bars statusbar supports several panels types, each with many features.
Gripper Visibility
The GripperVisible property on the StatusBar class controls whether the gripper is visible on the statusbar. If set to true, the gripper will be visible. A value of false hides the gripper.
Modifying Child Panels
The Panels collection stores all of the panels that are contained by the statusbar. To programmatically add a new panel to the statusbar, simply add it to collection. The collection can be edited in the designer to add and configure new panels as well.
Statusbar Panels
Each panel class inherits from the StatusBarPanel class. This class provides a number of properties that are common to all panels:
| Member | Description |
|---|---|
| AutoSize Property | Gets or sets the auto-size style to apply to the panel. |
| BackgroundFill Property | Gets or sets the BackgroundFill to use for the background of the panel. |
| Border Property | Gets or sets a SimpleBorder that indicates the type of border for the panel. |
| Key Property | Gets or sets the key of the panel. |
| MinimumWidth Property | Gets or sets the minimum width for the panel. |
| Padding Property | Gets or sets a Padding that describes the padding of the panel. |
| ToolTipText Property | Gets or sets the tool tip text for the panel. |
| Visible Property | Gets or sets whether the panel is visible. |
| Width Property | Gets or sets the width of the panel. |
| AutoSize Property | Gets or sets the auto-size style to apply to the panel. |
Statusbar Label Panels
The StatusBarLabelPanel class provides a panel that can display images and text in various formats. It has these important properties:
| Member | Description |
|---|---|
| Enabled Property | Gets or sets whether the panel is enabled. |
| ForeColor Property | Gets or sets the Color to use for drawing the text. |
| HorizontalAlignment Property | Gets or sets the horizontal alignment of text in the panel. |
| Image Property | Gets or sets the image that is displayed for the panel. |
| ImageIndex Property | Gets or sets the index of an image within an ImageList that is displayed on the panel. |
| ImageLayoutStyle Property | Gets or sets the layout style of the panel's image in relation to the text. |
| ImageSizeToFit Property | Gets or sets whether to size the panel's image to fit in the panel. |
| IsLink Property | Gets or sets whether the panel is a link. |
| LinkBehavior Property | Gets or sets the link behavior. |
| LinkVisited Property | Gets or sets whether the link has been visited. |
| Text Property | Gets or sets the text to display in the panel. |
| TextTrimming Property | Gets or sets the StringTrimming to use for text in the panel. |
Statusbar Progressbar Panels
The StatusBarProgressBarPanel class provides a panel that can display progressbars. It has these important properties:
| Member | Description |
|---|---|
| Increment Method | Advances the current value of the progress bar by the specified amount. |
| Maximum Property | Gets or sets the upper bound of the range that is defined for this progress bar. |
| Minimum Property | Gets or sets the lower bound of the range that is defined for this progress bar. |
| PerformStep Method | Advances the current position of the progress bar by the amount of the Step property. |
| Step Property | Gets or sets the amount by which a call to the PerformStep method increases the current position of the progress bar. |
| Style Property | Gets or sets the StatusBarProgressBarPanelStyle that indicates how the progress bar should indicate status. |
| Text Property | Gets or sets the text to display in the panel. |
| TextTrimming Property | Gets or sets the StringTrimming to use for text in the panel. |
| Value Property | Gets or sets the current value of this progress bar. |