SaStatusBar(3tlib)

SaStatusBar: SaStatusBar, SaStatusBarSet, SaStatusBarClear, SaStatusBarGet -- SCO Visual Tcl interface for graphical status bars on forms

Synopsis

SaStatusBar name [main] [pixmap]
SaStatusBarSet [statusbar text]
SaStatusBarClear [statusbar]
SaStatusBarGet [statusbar]

Description

SaStatusBar provides a convenient and consistent interface to manage graphical status bars for SCOadmin applications. The status bar is typically used for intermittent status messages and for point help. The main form dialog of an application should provide a status bar. On secondary forms, they are optional.

The status bar appears at the bottom of the form, delineated from the rest of the form above by a separator. It assumes the full width of the form with a space for text on the left and a SCOadmin icon on the right. A custom icon can be provided by the application. Secondary form status bars ommit both the separator and the icon.

The SaShortHelp and SaStatusBar interfaces were designed to be used together.

SaStatusBar: create a status bar on a particular form. Returns the widget string for a new form containing the status bar components. The status bar should be the last widget created on the form.
SaStatusBarSet: sets the text string showing in the status bar.
SaStatusBarGet: gets the text string showing in the status bar.
SaStatusBarClear: clears the text string from the status bar.

Arguments

name: SCO Visual Tcl widget name for the new status bar. The name consists of the widget string for the parent form and a name that is unique among other widgets on the form.
main: optional boolean indicating whether or not this status bar lives on the main form dialog or a secondary dialog. Default is 1 (true). This is used to compute the size of the status bar in the CHARM (character Motif) case.
pixmap: optional full pathname of a pixmap that will appear in the main form dialog status bar. Defaults to the standard SCOadmin status bar pixmap.
statusbar: SCO Visual Tcl widget string (returned from SaStatusBar) for a specific status bar instance.
text: text string to appear in the status bar.

References

SaShortHelp(3tlib).