Class: cStatusBar [Obsolete]

Properties Events Methods Index of Classes

A control, usually placed at the bottom of a window, that is divided into "panes"

Hierarchy

cObject
---cUIObject
------DfBaseObject
---------DfBaseWindow
------------DfBaseUIWindow
---------------DfBaseControl
------------------cWinControl
---------------------cStatusBar

Library: Windows Application Class Library

Package: cStatusbar.pkg

Description

This class is obsolete. Status Bars are now created using class cCJStatusBar.

As of revision 12.1, DataFlex includes full support for Codejock Software's COM Xtreme CommandBars package for creating menus, toolbars and statusbars. See Using Menus, Toolbars and Statusbars for more information.

The statusbar is a control, usually placed at the bottom of a window, that is divided into "panes". Each pane is used to show either a string or an icon. The status bar is used to relay information to a user about the program. For example, you may have a pane that shows the current View and another that shows status-help for the currently-focused control.

To create the panes, embed objects derived from cStatusPane. The last pane will automatically stretch to the end of the statusbar.

The statusbar has two modes: Simple, where a single string is displayed across the whole statusbar, and Panes, where the multiple panes are displayed. Only one mode is active and that is determined by the pbSimple property.

Use the piBackColor property to set the color of the statusbar, and the pbSizeGrip property to position a Grip in the bottom-right corner as visual indicator that the panel containing the statusbar can be resized.

Usually, the statusbar is part of the MDI interface. In this mode, the statusbar will automatically size and align itself with the panel's client-area.

If you want to use the statusbar in a non-MDI container, set its pbInMdiPanel property to false, to prevent it from communicating with the MDI interface. To prevent the statusbar from aligning to the bottom of the parent window, change the peAlign property to alNone and size and locate the statusbar manually.

Sample

Object oStatusBar is a cStatusBar
 
    Object oStatusHelp is a cStatusPane
        Set piWidth To 350
    End_Object
 
    Object oViewLabel is a cStatusPane
        Set piWidth To 40
        Set psLabel To "View:"
        Set peBevel To bsNone
    End_Object
 
    Object oViewName is a cStatusPane
        Set piWidth To 200
    End_Object
 
End_Object