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

Description (short)
value management (-value), as in Tix
Written by
Andreas Kupries
Description
management for option -variable of a widget displaying an array. Actually a stripped down version of valueManager.
Keywords
value management, -value, widgets

Class 'watchAManager'

Description
Defines and manages the option '-variable'. Derived classes must provide the methods 'initDisplay', 'updateDisplay' and 'clearDisplay'. They have to refresh the shown information according to the changed value.
Superclasses
widget
Options
variable
Methods
public
InitializeManager ()
TrackVarContents (var idx op)
TrackVariable (o oldValue)
initDisplay ()
updateDisplay ()
watchAManager ()
~watchAManager ()
Membervariables
public
operation
item

Options

-variable
Name of the (global) variable associated to the widget. Any changes to its contents are propagated into the widget and vice versa.

Methods

InitializeManager ()

Special method, is called after the completion of the construction of widget and its components. Initializes the value of the widget according to the contents of the associated variable, if defined.

TrackVarContents (var idx op)

Internal trace callback to monitor the value of the array variable associated to the widget.
Argument: var Standard trace argument, base name of traced variable
Argument: idx Standard trace argument, name of array item.
Argument: op Standard trace argument, operation invoking the trace.

TrackVariable (o oldValue)

Configure procedure. Used to track changes to the value of -variable. Removes the traces set upon the old associated variable, then links in the new variable and its contents.
Argument: o The name of the changed option.
Argument: oldValue The value of the option before the change.

initDisplay ()

Dummy method, must be overridden by derived classes. This one will only throw an error.

updateDisplay ()

Dummy method, must be overridden by derived classes. This one will only throw an error.

watchAManager ()

Special constructor. Schedules the execution of the real initialization to happen after the standard initialization and the creation of all component widgets of the derived class.

~watchAManager ()

Special destructor. Removes the association between the widget and the variable specified in '-variable', if the latter is not empty. This is accomplished through the deletion of the variable trace set earlier by this widget.


Membervariables

operation
The last operation on the array we are connected to, as given by the trace callback (TrackVarContents).
item
The key used by the last operation on the array we are connected to, as given by the trace callback (TrackVarContents).

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