# StatusBar

Typically, a `StatusBar` control consists of `StatusBarPanel` objects, each of which displays text and/or an icon. You can also provide owner-drawn panels to provide custom panels such as a progress bar or a series of images that displays the state of your application. A `StatusBar` control typically displays information about an object being viewed on a Form, the object's components, or contextual information that relates to that object's operation within your application.

The `StatusBar` control provides properties that enable you to customize the appearance of the control. If the `StatusBar` is displayed on a form that can be resized, you can use the `SizingGrip` property to display a sizing grip in the lower-right corner of the form to indicate to users that the form can be resized. The `ShowPanels` property enables you to display panels within your `StatusBar` or to display only the value of the `Text` property of the control.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### AutoSize

The `AutoSize` property of the `StatusBarPanel` provides a few preset ways to customize the size of the panel.

* `None`: The `StatusBarPanel` does not change size when the control resizes.
* `Spring`: The `StatusBarPanel` uses the available space on the `StatusBar`.
* `Contents`: The width of the `StatusBarPanel` is determined by its contents.

![AutoSize Example](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-b5fd5dbb03c94802775a1130132cae46cc6eb5c2%2Fimage.png?alt=media)

### Panels

Any number of Panels can be added to a `StatusBar` using the `Panels` property. The panels can be customized to include an icon, text, and custom spacing.

![Panels Example](https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-1b15b2e1139eb61c62db27508097dad3715b6aec%2Fimage.png?alt=media)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                                                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.StatusBar"                                                                                                                                                                                                           |
| Theme appearance | "statusbar", see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                                                                                                                                        |
| Child components | "label" is the container for the status bar's labels. "panel" is the statusbar container. "grip" is the drag button in the bottom right corner. See [JavaScript](https://docs.wisej.com/docs/concepts/javascript-object-model). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                                                                                             |