# Sandbox.UI.StatusBar

A strip of normal status widgets on the left and permanent widgets on the right.
Temporary messages replace the left widgets without deleting them.

- Kind: class
- Namespace: `Sandbox.UI`
- Assembly: `Sandbox.Engine`
- Inherits: [Sandbox.UI.Panel](/api/Sandbox.UI.Panel)

## Constructors

- [`StatusBar`](/api/Sandbox.UI.StatusBar/.ctor)

## Properties

- [`Left`](/api/Sandbox.UI.StatusBar/Left): Normal widgets, hidden while a message is displayed.
- [`Message`](/api/Sandbox.UI.StatusBar/Message): The current temporary message, or an empty string.
- [`Right`](/api/Sandbox.UI.StatusBar/Right): Permanent widgets, visible even while a message is displayed.

## Methods

- [`AddLeft`](/api/Sandbox.UI.StatusBar/AddLeft): Add and own a normal widget. Stretch distributes spare space within its slot.
- [`AddRight`](/api/Sandbox.UI.StatusBar/AddRight): Add and own a permanent widget.
- [`AddSeparator`](/api/Sandbox.UI.StatusBar/AddSeparator): Add a separator to the normal or permanent slot.
- [`ClearMessage`](/api/Sandbox.UI.StatusBar/ClearMessage): Clear the message and restore the normal widgets.
- [`RemoveWidget`](/api/Sandbox.UI.StatusBar/RemoveWidget): Remove a direct slot widget without deleting it. The caller takes ownership.
- [`ShowMessage`](/api/Sandbox.UI.StatusBar/ShowMessage): Replace the current message. Positive seconds expire automatically; zero or negative seconds keep the message until replaced or cleared. Empty text clears it.
- [`Tick`](/api/Sandbox.UI.StatusBar/Tick)