Version 6.3.8 for Windows
 —  Dialog Component Reference  —

Status Bar Control

This document covers the following topics:


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.

Top of page

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

Top of page

Events

This dialog element does not create events.

Top of page