Status bar control style

Status line controls are defined in order to display status information as column or row numbers, progress bars or text informing about ongoing operations or events. Typically, the status bar is displayed at bottom of the application window. The control style for a status bar style does not contain specific data. Border options are available but will be ignored.

In order to define a status bar, a field control has to be defined (in the main control), that refers to a status line control. The status line field does not require a data source, i.e. the data reference type in the status bar data source should be set to undefined.Also all other field options and field control options except Height will be ignored. The Height determines the height of the status bar.

By default, status bar information is filled from the tool tip information defined for a buttons and menu items. The application may pass status bar information by calling ControlContext::setText().

By adding more fields to the status line control (ADK_FieldControl), 'normal' and permanent elements might be added to the status line:

• Normal - occupies part of the status bar and may be hidden by status bar text. The area is used to display e.g. page and line numbers.
• Permanent - is never hidden. Permanent fields are used for important application mode indications, e.g. Caps Lock or Insert mode.

Permanent and normal are concepts known to Qt but not to the GUI framework. In order to support arranging status line fields in normal and permanent area, the horizontal position in the field definition is used, instead. Permanent fields, which are displayed on the right most side of the status bar, are defined by setting the horizontal position for a status field definition to right (HPS_InnerRight). Any other value is considered as indication for a normal status line fields, which are displayed left of the permanent fields. In order to create, update or browse status bar styles, one may select Objects/Styles/Status Bar.