File 'gui/stateline.cls' (part of 'Pool_GuiBase')


Home | Packages | Files | Procedures | Classes | Keywords | External packages


Written by
Andreas Kupries
Description
Stateline widget. Is able to handle more than one source of messages.
Keywords
stateline

Class 'stateline'

Description
Instances of this class display a line containing a textual message. The shown message can be changed at runtime. Setting the empty string as message is possible and clears the shown line. There is a little more than that to it. Messages are always associated with a symbolic name (= handle) and if different handles are used the widget will display the message associated to the handle used in the last set statement. Clearing the message of a particular handle will cause the system to display the message of the second last handle, and so on. The display will be cleared only if all messages of all handles are cleared by the user. Setting a message for a known handle overwrites the message associated to it.
Superclasses
widget
Membervariables
handles, messages
Methods
createSubwidgets, setText

handles
A list of the handles whose texts are known to the widget. Managed as a stack, the leftmost position (index 0) is its top.
messages
Maps form handles to their strings. The string associated to the leftmost handle in handles is actually displayed. Associating an empty string to that handle causes its removal from map and stack, and the text of the handle below it is displayed.

createSubwidgets ()

Creates and packs the widget required by the stateline.

setText (handle text)

Accessor method to place a message in the stateline.
Argument: handleThe symbolic name associated to the message. Can be used between messages from several different #sources.
Argument: textThe text to show in the stateline.


Generated by AutoDoc 2.1 at 02/20/1999, invoked by Andreas Kupries