This document covers the following topics:
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.
| 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 |
This dialog element does not create events.