Version 6.3.8 for Windows
 —  Dialog Component Reference  —

Status Bar Pane

This document covers the following topics:


Description

A status bar pane is a logical section of a status bar control. You can define more panes than are physically visible in the control by selectively setting the VISIBLE attribute of those logical panes which should not appear, according to the application context (for example, depending on which MDI child dialog is active).

A pane can be stretchy or non-stretchy. A stretchy pane is indicated by setting the pane's RECTANGLE-W attribute to zero. The width of a stretchy pane changes when the width of the parent dialog is changed, and is determined by the following formula:

width = (available width - total width of all non-stretchy panes) / no. of stretchy panes

The first (visible) stretchy pane is referred to as the message pane, and is used as the default pane in cases where no pane is explicitly specified. This is the case, for example, when text is output by setting the status bar control's STRING attribute or the dialog's STATUS-TEXT attribute.

Both an icon and a string can be specified for a pane by setting the pane's BITMAP-FILE-NAME and STRING attributes, respectively. If the ENABLED attribute is set to FALSE, both the icon and string are either grayed out or completely suppressed (depending on a pane-style flag setting). Furthermore, the status bar pane supports the TOOLTIP attributes, allowing pane-specific tool tips to be specified when the mouse pointer hovers over the pane.

Top of page

Attributes for Status Bar Pane

Attribute Name Query Set/Modify In Attr. Window
BITMAP-FILE-NAME X X/X X
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
LAST-CHILD X -/-  
PARENT X X/-  
PREDECESSOR X -/-  
RECTANGLE-W X X/X X
SHARED X X/X X
STRING X -/X X
STYLE X X/- X
SUCCESSOR X X/-  
SUPPRESS-CLICK-EVENT X X/X  
SUPPRESS-DBL-CLICK-EVENT X X/X  
TOOLTIP X X/X X
TYPE X X/-  
VISIBLE X X/X X

Top of page

Events

Click Event, Double-Click Event (all events may be suppressed).

Top of page