StatusArea is a megawidget that is a container
for status items. Status items, sometimes called
status bars are arranged as a set of vertically
stacked widgets inside the
In most but not all cases, status items will be simple label
widgets intended to provide textual information about the status
of some facet of the program. The
provides methods that simplify the creation and management of these
A singleton implementation is also available.
This adds an arbitrary widget to the status area.
args should be a widget creation
command without the window path (This gets generated by
addWigdget). For example:
Adds a checkbutton control to the status bar. To add
frames containing multiple widgets to the status bar,
create a megawidget (with snit or itk for example) and
pass the megawidget constructor name to the
The widget will be added to the bottom of the status area. The actual widget path is returned by this method.
Adds a message to the bottom of the status window.
Messages are implemented as label widgets.
If provided the optional
initial-text argument is the
text initially displayed by the widget.
The method returns a message handle.
The message handle is not the widget
path of the label widget. It can be used in other
message related methods (e.g.
setMessagehandle text args
Changes the message text displayed by the message
referred to by
text. If additional parameters
are supplied the must be option/value pairs that are
valid for configuring a
The example below creates a message widget and outputs some text in it colored green:
Returns a list of the widget paths that
of the widgets in the status area. This includes
the message widgets as well as the other widgets you
may have added with
Slightly mis-named method returns the widget paths
of the ttk::label widgets
created by the
::StatusBar::getInstance returns the
widget path for the singleton status area widget.
The first time it is called, the otherwise optional
widget path for the status area must be passed in, and
will be created.