Tornado API Reference : GUI Tcl Library (UNIX)

motiftcl

NAME

motiftcl - motif Tcl library

TCL PROCEDURES

ttySend - send text to a subprocess through the tty interface
wsTitleSet - set the text of the window manager title bar
wsArgv - examine/change original window system command arguments
wsRestart - restart the application
wsObjectSelect - change to the help cursor and return the name of the object
delayedEval - arrange for an expression to be evaluated later
wsSync - flush pending requests to the window system
wsWindowId - return the X Window ID of the application's top level window
wsWindowGeom - return the geometry string of a window
wsWindowIconic - report whether a given window is iconified
wsHierarchy - print the window system hierarchy of graphical objects
wsBusyAnimation - check or set busy animation

DESCRIPTION

This library allows to use motif interfaces for Tcl UNIX GUI

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

ttySend

NAME

ttySend - send text to a subprocess through the tty interface

LOCALE

UNIX GUI

SYNOPSIS

ttySend text

DESCRIPTION

If the user interface has a tty connection to a subprocess, ttySend sends the supplied text directly to the subprocess as if it had been typed at the subprocess terminal.

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

wsTitleSet

NAME

wsTitleSet - set the text of the window manager title bar

LOCALE

UNIX GUI

SYNOPSIS

wsTitleSet title

DESCRIPTION

This function sets the window manager titlebar text to the specified title

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

wsArgv

NAME

wsArgv - examine/change original window system command arguments

LOCALE

UNIX GUI

SYNOPSIS

wsArgv [argList]

DESCRIPTION

With no arguments, this function returns the original argument vector used to launch the application, including the program name and all window-system-specific arguments. If an argument list is given, this list replaces the argument list that is used by the wsRestart command.

SEE ALSO

motiftcl, wsRestart


GUI Tcl Library (UNIX) : Tcl Procedures

wsRestart

NAME

wsRestart - restart the application

LOCALE

UNIX GUI

SYNOPSIS

wsRestart [arg arg...]

DESCRIPTION

This command restarts the application with the same arguments it was originally invoked with. If arguments are supplied, they are appended to the arguments originally used to invoke the program.

RETURNS

This command does not return.

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

wsObjectSelect

NAME

wsObjectSelect - change to the help cursor and return the name of the object

LOCALE

UNIX GUI

SYNOPSIS

wsObjectSelect

DESCRIPTION

The window cursor changes to a "question arrow" shape. If the user clicks on a screen object that has an internal name, that name is returned. If the user clicks outside the application, clicks on an unknown object, or cancels the selection operation, an empty string is returned.

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

delayedEval

NAME

delayedEval - arrange for an expression to be evaluated later

LOCALE

UNIX GUI

SYNOPSIS

delayedEval time expr

DESCRIPTION

This command arranges for expr to be evaluated in the global Tcl context after time milliseconds have expired.

RETURNS

Nothing. Errors returned by the evaluation of expr are discarded.

CAVEATS

The X Toolkit timeout mechanism is used (see XtAppAddTimeout( ) in the Xt library reference). If the application is not executing the X Event Loop when the timeout should expire, the evaluation of expr is delayed until the X Event Loop is resumed.

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

wsSync

NAME

wsSync - flush pending requests to the window system

LOCALE

UNIX GUI

SYNOPSIS

wsSync

DESCRIPTION

This command flushes pending requests to the window system. This is useful when an application is about to perform a long computation or block on a subprocess, preventing the X event loop from executing.

RETURNS

Nothing.

SEE ALSO

motiftcl, wsWindowIconic, wsWindowId, wsWindowGeom


GUI Tcl Library (UNIX) : Tcl Procedures

wsWindowId

NAME

wsWindowId - return the X Window ID of the application's top level window

LOCALE

UNIX GUI

SYNOPSIS

wsWindowId

DESCRIPTION

This function returns the window ID of the top level window of the application executing this command.

RETURNS

Window ID, in hexadecimal.

SEE ALSO

motiftcl, wsSync, wsWindowIconic, wsWindowGeom


GUI Tcl Library (UNIX) : Tcl Procedures

wsWindowGeom

NAME

wsWindowGeom - return the geometry string of a window

LOCALE

UNIX GUI

SYNOPSIS

wsWindowGeom windowId

DESCRIPTION

This command returns the geometry string of the window. The format of this string is widthxheight+x+y. This string can be used as the -geometry argument of an X client command.

RETURNS

An X Window System geometry string.

SEE ALSO

motiftcl, wsSync, wsWindowId, wsWindowIconic


GUI Tcl Library (UNIX) : Tcl Procedures

wsWindowIconic

NAME

wsWindowIconic - report whether a given window is iconified

LOCALE

UNIX GUI

SYNOPSIS

wsWindowIconic windowId

DESCRIPTION

Given an X Window ID, this function reports whether the window is iconified or not.

RETURNS

1 if the window is iconified; 0 otherwise.

SEE ALSO

motiftcl, wsSync, wsWindowId, wsWindowGeom


GUI Tcl Library (UNIX) : Tcl Procedures

wsHierarchy

NAME

wsHierarchy - print the window system hierarchy of graphical objects

LOCALE

UNIX GUI

SYNOPSIS

wsHierarchy

DESCRIPTION

This function prints the widget hierarchy of the application to standard output. This command is primarily for debugging. The name and class of each widget is printed, with indentation used to show the hierarchy structure. If a widget is a popup child of its parent, this is indicated by > before the widget's name.

SEE ALSO

motiftcl


GUI Tcl Library (UNIX) : Tcl Procedures

wsBusyAnimation

NAME

wsBusyAnimation - check or set busy animation

LOCALE

UNIX GUI

SYNOPSIS

wsBusyAnimation [on | off]

DESCRIPTION

If a parameter is given and is on, this function starts the "application busy" animation; it runs until the state is set to off. If no state is supplied, the current state is returned. It is not an error to supply the current state; in this case, the command has no effect.

RETURNS

on or off if no parameter is given, nothing otherwise.

SEE ALSO

motiftcl