SaStatusBar(TCL_ADM)
SaStatusBar: SaStatusBar, SaStatusBarSet, SaStatusBarClear, SaStatusBarGet --
SCO Visual Tcl interface for graphical status bars on forms
Syntax
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.
See also
SaShortHelp(TCL_ADM),
SCO Visual Tcl Programmer's Guide and Reference in SCO Visual Tcl Programmer's Guide and Reference.
16 September 2002
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003