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

Description (short): stateline widgets
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

Methods

public: createSubwidgets ()
setText (handle text)

Membervariables

public: messages
handles

Methods

createSubwidgets ()

Overrides widget:createSubwidgets
Creates and packs the widget required by the stateline.

setText (handle text)

Accessor method to place a message in the stateline.

Argument: handle The symbolic name associated to the message. Can be used between messages from several different #sources.

Argument: text The text to show in the stateline.

Membervariables

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.
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.

Generated by AutoDoc 2.4 at 09/14/2000, invoked by Andreas Kupries

createSubwidgets ()
Overrides widget:createSubwidgets Creates and packs the widget required by the stateline.

setText (handle text)
Accessor method to place a message in the stateline.
Argument: handle	The symbolic name associated to the message. Can be used between messages from several different #sources.
Argument: text	The text to show in the stateline.