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).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004