TmRoot

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

-appContext appContext

This allows the application context to be made into a separate command appContext as well as accesible through `.'. This may be useful if you wish to have multiple application contexts or use multiple displays.

-class class
-fallbackResources resources

These are in a tcl list, as in

        {
                {*list.visibleItemCount: 10}
                {*quit.labelString: Quit}
        }

-options options

These set the application options. The options is a list of option values. Each option value consists of the command line option (such as -helpFile), the resource name (such as helpFile) and the type of command line argument supported. Possible values for this are

noArg
sepArg
stickyArg
resArg
skipArg
skipLine

For example,

-options {
        {-helpFile helpFile sepArg} 
        {-showHelp showHelp isArg}
    }

METHODS

addInput
removeInput
addTimer
removeTimer
addWMProtocolCallback
getAppResources
mainLoop
pending
processEvent

addInput file mode command

This method adds the tcl command as an input handler for the file, according to the mode specified. This can be `r' for read, `w' for write or `x' for exception. Whenever the file is ready for the requested operation the tcl function is called to handle it. The command returns an XID which is an identifier for the input handler.

removeInput inputID

This method removes the file handler added by addInput. It takes as argument the identifier returned from ``addInput''.

addTimer interval command

This method adds the tcl command to an Xt timer. The interval is in milliseconds. The command returns an XID which is an identifier for the input handler.

removeTimer timerID

This method removes the timer added by addTimer. It takes as argument the identifier returned from ``addTimer''. Note that if an attempt is made to remove a timer that has gone off, Xt has unspecified behaviour.

addWMProtocolCallback atom command...

This adds the command as a callback when the window manager sends a message given by the atom. Atoms defined by ICCCM are WM_TAKE_FOCUS, WM_DELETE_WINDOW (normally sent when the Close button from the Window manager menu is selected) and WM_SAVE_YOURSELF.

mainLoop

This starts the Xt event processing loop

pending

The checks the Xt even t queue without processing any events. It returns a list of event types currently queued. The elements of the list can be "XEvent", "Timer" or "AlternateInput". If no events are pending, the list will be empty.

processEvent

This processes the next event, along with any timers and input handlers. It is supplied here for use in modal dialogs.

CALLBACK SUBSTITUTIONS

BUGS

AUTHOR

Jan Newmarch, University of Canberra

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

METHODS

CALLBACK SUBSTITUTIONS

BUGS

AUTHOR