Skip to main content

TdxStatusBarPanel Class

The object that implements the functionality of a status bar‘s panel.

Declaration

TdxStatusBarPanel = class(
    TCollectionItem
)

Remarks

The TdxStatusBarPanel class implements the functionality of the status bar panel used on a status bar.

Built-in status bars provide the following panel types:

  1. Text panel – Allows you to display simple text labels or control hints. For example, you may use it to display “Connected”, when your networking application successfully establishes a connection to a remote host.

  2. Container panel – Enables you to insert controls into a status bar. You can add images, edit fields, progress bars, checkboxes and other controls.

  3. Keyboard State panel – Tracks the state of the keyboard modifiers: CAPS LOCK, NUM LOCK, SCROLL LOCK and Insert/Overwrite. The keyboard state panel can be easily integrated into text processing applications.

  4. State Indicator panel – Provides you with visual indicators. You can use them to track network activity, the state of modem, communication adapter or other devices.

  5. Toolbar panel (available only for the Ribbon status bar) – Allows you to dock a toolbar into the status bar.

The panel type is specified by the PanelStyle property. Note that it is also possible for a panel to have PanelStyle unassigned and it will then provide basic text capabilities only.

Each TdxStatusBarPanel instance is a member of the TdxStatusBarPanels collection. At design time, you can access this collection via the Panels property of the TdxStatusBar or TdxRibbonStatusBar control in the Object Inspector.

You can also manage status bar panels at runtime, by using the standard TCollection methods and properties, such as Add, Insert, Delete, etc.

You can use the status bar’s SimplePanelStyle.Active property to optionally switch the status bar to display a single text panel rather than all the created panels. This functionality is similar to the SimplePanel property found in the standard VCL TStatusBar component.

Inheritance

See Also