
        \\\\\\\\\\\\\\\\\\\\ ///////////////////////

        example programs using the xvobjects lib

        //////////////////// \\\\\\\\\\\\\\\\\\\\\\

01.canvas/
   
   This example creates a canvas object;  it then creates two label
   widgets on the canvas; one at the top, one at the bottom.  It does
   not work with Motif, but not much does so it is in good company.

   It also creates a button on the canvas that you may use to change
   the background pixmap of the canvas. (Mostly to show off all the
   cool background pixmaps available).

02.double/

   This example creates a simple double GUI object, which may
   be used for allowing the user to enter a double.  
 
   A callback is installed on the double object so that when the 
   user changes the value of the double either by entering a number
   in the text parameter box and hitting <cr> or by using the scrollbar,
   the current value is printed to the tty.

03.float/

   Very similar to the 02.double/ example, this program creates a float GUI 
   object, and installs a callback which prints the value when it is changed.

04.integer/

   Very similar to the 03.float/ example, this program creates a float GUI 
   object, and installs a callback which prints the value when it is changed.

05.inputfile/

   This example creates a simple inputfile GUI object, which may
   be used for allowing the user to enter a input file.  The user may
   enter a value in the text parameter box, or click on the label button,
   which will bring up the file browser from which a file may be picked.
 
   A callback is installed on the input file object so that when the
   user changes the value of the input file, the current
   filename is printed to the tty.

06.outputfile/

   Very similar to the 05.inputfile/ example, this program creates an 
   outputfile GUI object, and installs a callback which prints the filename
   when it is changed.

07.textinput/

   This example creates a simple textinput GUI object, which may
   be used for allowing the user to enter text.
   A callback is installed on the textinput object so that when the
   user changes the text and hits <cr>, the current text is printed to the tty.

08.rowcol/

   This example shows how the RowCol object can be used for convenient,
   uniform layout of buttons (or labels) in rows and columns.  When objects
   need to be laid out in rows, a rowcol object backplane is also significantly 
   faster than a manager object backplane doing relative or absolute layout.

   The RowCol object will lay out as many children in the first row
   as it can fit given it's relative width;  it then continues in
   a second row, and goes on to N rows until all children are created.
   When the RowCol object is set to resizable and when its edges are tacked,
   the user can interactively resize the RowCol object, which will
   automatically re-layout its children according to the new size.

09.help/

   The program demonstrates the help object.  The help object displays
   a help file which is formatted with "roff" commands.  The commands  
   are interpreted, and the formatted output displayed.  
 
   % example
             displays the default help files in the "guise" help directory
 
   % example {directory}
             displays the help files in the directory specified
 
   IMPORTANT NOTE: this example will not work properly if you do not have
                  groff, gtbl, and geqn installed on your system.

   ALSO NOTE: the help object takes a while to display. be patient.

10.error/

   This example creates an error object to display an error message.

11.warn/

   This program creates a warning object to display a warning message.

12.info/

   This example uses an info object to display some information.

13.notify/
  
   This example demonstrates the use of a notify window to inform the
   user of what's going on when a program is working (and will be working
   for a while).

14.viewport/

   This program demonstrates the use of the viewport object.  A viewport
   with both horizontal and vertical scrollbars is created.  Then, a
   line of labels is created along the left side (too many to fit in
   visible space of viewport), and a line of labels is created in a row
   (too many to fit in visible space of viewport).  The viewport scrollbars
   can be used in order to see all the labels.

15.textdisplay/

   This example shows how the textdisplay object, created with
   xvw_create_textdisplay(),  is used to display a text file.  If
   the file is formatted with "roff" commands, those commands will be
   interpreted, and the file formatted as specified.

16.pixmap/

   This example creates a set of pixmap objects, laying them out in rows
   by using a rowcol object as the parent.  The pixmap object,
   as opposed to a label displaying a pixmap, is slightly faster and designed
   specifically for the display of pixmaps.  Note that the pixmaps displayed
   are *really* of different sizes; it's not a bug that the hex and the 
   esher grid are smaller than the others.

17.rootwindow/

   This variation on the relative layout example 
   (see examples/xvwidgets/11.relative_layout)
   illustrates how the rootwindow object can be used as a parent to other
   objects, to make the children objects appear directly on the root window.

19.console/

   This displays a console object, which prints messages in one second
   increments.

20.labelstr/

   This example creates a simple labelstring object 
   that prints out those Famous Words, "Hello World".

21.layout/

   This example shows how a layout object can be used to lay out
   a number of area objects (containing plot objects) neatly without
   explicit location specification.
 
   An "Add Another Plot" button underneath invokes a callback which
   creates a new area object within the layout object.

22.browser/

   This example creates a browser object and installs on it a callback
   which will print the file that was selected by the user and then exit.


