Microline Widget Library 3.0 Integration Files
	      ----------------------------------------------

This directory contains the files required to integrate the
Microline Widget Library 3.0 into WorkShop Visual 6.0.

This directory (Microline) should be placed in the user_widgets
subdirectory of the WorkShop Visual distribution.

Files contained in this directory are as follows:

	Makefile      - creates visu binary w/Microline
			Widget Library
	XmL.xdc       - visu_config configuration file
	XmLiface.c    - resource integration code
	XmLiface.h    - resource integration header file
	bitmaps       - bitmaps
	app-defaults  - resources

How To Integrate the Library

1. Start visu_config and use the File/Open menu option to load
   the XmL.xdc file. The Microline family should be listed.

2. Select Microline in the Families list and then select the
   'Config file' option from the Generate menu.  Click on OK to
   generate the XmLconfig.c file. Repeat this procedure for the
   'Code file' menu option to generate XmLcode.c.

3. Check that the Makefile has appropriate settings and path names
   for your system.  Build the visu binary using 'make'.
   After the build has successfully completed a
   '@XDBINARY.bin' executable incorporating the Microline widgets
   will have been created in the current directory.

4. This binary may be invoked by setting the environment variable
   USER_WIDGETS to the name of this directory (i.e. USER_WIDGETS=Microline)
   and invoking WorkShop Visual as normal.

5. This widget integration can be made the default for your site by
   moving or copying this directory to 'local' (including any
   bitmap and app-defaults sub-directories).

Helpful Hints
-------------

-  Many of the resources available on the Grid are not available to
   be set under WorkShop Visual including any row, column or cell
   attributes.  Only global Grid resources can be set through the
   WorkShop Visual interface.

   All of the resources are in fact listed within the XmL.xdc
   config file, but certain of the Grid resources are marked as not
   visible.

-  To add a tab to a Folder, create an XmDrawnButton child of the
   Folder, it will appear as a tab.  Tabs in the Folder contain
   Primitive-based widgets which the Folder draws tab decorations
   around.  This allows you to set resources and edit a tab just as
   you would an XmDrawnButton.

-  When you have overlapping widgets, such as two Forms in
   a Folder, you can bring one to the top by dragging the widget
   you want to appear at the top "up" in the widget hierarchy.

-  To attach a Form in a Folder to a tab (a DrawnButton child of the
   Folder), set the XmNmanagedName of the Form and the XmNmanagedName
   of the DrawnButton to the same value (PageOne for instance).

   The XmNmanageName appears as a constraint resource on
   DrawnButtons and Forms when they are children of a Folder.  You
   can set this resource by selecting the widget you want to modify
   and choosing the "Widget" file pulldown in WorkShop Visual and
   selecting "Constraints".

   If you attach all the tabs (DrawnButtons) to Manager widget
   children of the Form using the XmNmanageName resource on each
   one, you will be able to select tabs to flip pages in
   WorkShop Visual.