TmUIL

Section: C Library Functions (3)
Updated: 24 July 1993
Index Return to Main Contents

NAME

TmUIL - the interface to the UIL system

DESCRIPTION

This is the interface to handling UIL files in tclMotif.

METHODS

The extra methods supported for handling UIL files are

: mrmOpenHierarchy
mrmCloseHierarchy
mrmFetchWidget
mrmFetchWidgetOverride

mrmOpenHierarchy file_list: This takes a list of files that are compiled UIL files (UID files) and opens the widget hierarchy. At most one widget hierarchy can be opened. This method is only available to the toplevel widget ``.''
mrmCloseHierarchy: This closes the widget hierarchy opened by mrmOpenHierarchy. This method is only available to the toplevel widget ``.''
mrmFetchWidget name: This method can be applied to any widget. It searches the opened hierarchy for the widget given by ``name'' and attaches it to the widget of the call.
mrmFetchWidgetOverride name [override-name] args...: This method can be applied to any widget. It searches the opened hierarchy for the widget given by ``name'' and attaches it to the widget of the call. The override-name can be used to specify a new widget name for the top widget, and the args list can be used to override resource values for the top widget.

Callbacks

Callbacks can be defined for widgets within UIL files. These should all call to the function ``tcl'' which takes a string argument. The string is the tcl command that will be executed when the callback is invoked.

Widget commands

When a widget tree is linked into the tclMotif tree by mrmFetchWidget, a traversal is made of this subtree, adding information to turn each of the UIL widgets into a tclMotif widget. This means that the UIL widgets can then be treated as tclMotif Core widgets, and use the Core methods such as manageChild, getValues, setValues, etc.

Testing UIL capability

Support for UIL is determined by a compile-time option in the tclMotif library. Early versions of tclMotif have no support. You can test for UIL support by examining the variable Tm_UIL. If this variable is not defined, then there is no support for UIL. If it has the value false (0) then the library has been compiled without support, and if it has the value true (1), it supports the Mrm functions.

BUGS

When the UIL tree is added, all the widgets in this are made into Core widgets rather than using their widget type to set appropriate methods. Complain if this is important to you.

AUTHOR

Jan Newmarch, University of Canberra

This document was created by man2html, using the manual pages.
Time: 04:19:06 GMT, December 02, 2024