DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
Writing a SCOadmin manager

Status bar and point help

The status bar is a standard SCOadmin control located on the lower edge of the screen which informs the user of status messages which are helpful to the user but do not warrant posting in a separate dialog box. The SaStatusBar(3tlib) manual page describes how to configure a status bar, as in this example:

   # Build the status bar
   # Standard SCOadmin status bar pixmap
   set logofile {}
   # Full pathname for non-SCOadmin status bar pixmap
   # set logofile "?"
   

if {[lempty $logofile]} { set statusBar [SaStatusBar $vtMain.statusBar 1] } else { set statusBar [SaStatusBar $vtMain.statusBar 1 $logofile] } VxSetVar $appvals(vtMain) statusBar $statusBar # Connect main screen widget bottom to statusbar if {$appvals(who)} { VtSetValues $mainList -bottomSide $statusBar }

The status bar can also be used to display ``point help'', informative help messages about different parts of the screen. In this example from the template, a message is displayed when when the cursor is moved over the Examine selection of the Who menu:
   set examine [VtPushButton $fileMenu.examine \
   	-label [IntlMsg EXAMINE] \
   	-mnemonic [IntlMsg EXAMINE_NM]  \
   	-shortHelpCallback SaShortHelpCB \
   	-shortHelpString  [IntlMsg EXAMINE] \
   	-callback UiExamineCB  \
   	-autoLock UiExamineCB]
   VxSetVar $parent examine $examine
Note the two lines involved with the point help: one to define the string (-shortHelpString [IntlMsg EXAMINE]) and the other to set up the callback for displaying it in the status bar (-shortHelpCallback SaShortHelpCB).

For information on setting up this capability (also known as ``short help'') see SaShortHelp(3tlib).

See also:


Next topic: Main list
Previous topic: Template toolbar procedure: UiBuildToolBar

© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005