TmUIL(3Tm)

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