Status Bar Control

#### Search Results

Search

# Status Bar Control

This document covers the following topics:

- Description

- Attributes for Status Bar Control

- Events

## Description

A status bar control is an alternative to the traditional status bar that is created by setting the dialog's HAS-STATUS-BAR attribute. However, the status bar control offers a range of advanced features which the tradional Natural status bars do not support. These new features include a Windows-like appearance with (optionally) recessed or raised sections - referred to as "panes" - and (optionally) a sizing grip (see illustration above). The status bar panes are themselves dialog elements, and are therefore documented under their own section below. Note that, although it is possible to define a status bar control with no panes, such a status bar control can only display a single text string. In order to use any of the advanced features, it is necessary to define one or more panes.

A status bar control can be displayed either at the top or bottom of a dialog. Furthermore, a dialog may have more than one status bar control. Status information set via the dialog's STATUS-TEXT attribute is automatically redirected to the status bar control (if any) specified by the dialog's STATUS-HANDLE attribute.

You can set a minimum pane height for the status bar control using the ITEM-H attribute. The distance between the items and the status bar control's border is determined with the MARGIN-X and MARGIN-Y attributes.

## Attributes for Status Bar Control

Attribute Name | Query | Set/Modify | In Attr. Window
--- | --- | --- | ---
BAR-ID | X | X/- |
CLIENT-DATA | X | X/X |
CLIENT-HANDLE | X | X/X |
CLIENT-KEY | X | X/X |
CLIENT-VALUE | X | X/X | X
CONTEXT-MENU | X | X/X | X
ENABLED | X | X/X | X
FIRST-CHILD | X | -/- |
FOLLOWS | X | X/X |
FONT-HANDLE | X | X/X | X
HAS-TOOLTIP | X | X/X | X
ITEM-H | X | X/X | X
LAST-CHILD | X | -/- |
LOCATION | X | X/X | X
MARGIN-X | X | X/X | X
MARGIN-Y | X | X/X | X
PARENT | X | X/- |
PREDECESSOR | X | -/- |
RECTANGLE-H | X | -/- |
RECTANGLE-W | X | -/- |
RECTANGLE-X | X | -/- |
RECTANGLE-Y | X | -/- |
STRING | X | -/X | X
STYLE | X | X/- | X
SUCCESSOR | X | -/- |
TOOLTIP | X | X/X |
TYPE | X | X/- |
VISIBLE | X | X/X | X

## Events

This dialog element does not create events.

### On this page

- Description
- Attributes for Status Bar Control
- Events