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

        example programs using the xvutils lib

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


01.browser/

  This program displays a file browser, and allows the user to select
  a file.  The name of the selected file is written out, or if the user 
  selects "Cancel", that is indicated.

02.listwait/

  This example demonstrates the two uses of xvu_run_list_wait().

  First, a list of fruit is popped up from which the user must choose one
  of the items provided; the user's choice is printed.  If "cancel" is 
  chosen, the default provided is considered the "choice".
 
  Second, a list of vegetables is popped up from which the user may pick an 
  item, or provide their own in the text parameter box provided; the user's
  choice is printed.  If "cancel" is chosen, the default provided is considered 
  the "choice".

03.multlistwait/

  This example demonstrates the four uses of xvu_run_list_multsel_wait().
 
  First, a list is popped up from which the user may choose one or more
  of the fruits provided. They may select each fruit only once (selected
  fruits are marked with a star), and may not provide their own list entry.
  When finished, the user may click on "Use";  user's selections are printed.

  Second, a list is popped up from which the user may choose one or more
  of the veggies provided. They may select each veggie only once (selected
  items are marked with a star), but they may provide their own vegetable
  by entering a string in the text parameter box and hitting <cr>, which
  adds the new string to the list.   They may then select their newly defined
  vegetable.  As many user-defined items may be created and selected as
  desired.  When finished, the user may click on "Use";  choices are printed.
 
  Third, a list is popped up from which the user may choose one or more
  of the meats provided. They may select each meat as many times as they
  like (selected meats are marked with with the number of times they have
  been selected), but they may not provide their own list entry.
  When finished, the user may click on "Use";  choices are printed.
 
  Fourth, a list is popped up from which the user may choose one or more
  of the noodles provided. They may select each noodle as many times as they
  like (selected noodles are marked with with the number of times they have
  been selected).  In addition, they may provide their own noodle
  entry by entering a string in the text parameter box and hitting <cr>, which
  adds the new string to the list.   They may then select their newly defined
  list item as many times as they like; choices are printed.

04.query/

  This program demonstrates the use of xvu_query_wait to pop up a
  query object in which the user can respond by entering values as
  instructed.  It gives two examples:  the first example uses the
  query object to prompt the user for a float constant (no default), 
  and the second example uses the query object to prompt the user for
  a set of labels.


05.textwait/

    This program creates a GUI with a button.  When the user clicks on the
    button, a pop-up text object appears;  the user can enter text as desired.
 
    This example illustrates the use of xvu_text_wait(). The xvu_text_wait()
    routine is a utility in xvutils which pops up a text object of predefined
    size, allows the user to enter text as desired, and returns the contents
    of the text object to the caller when the user clicks on "Use".  If the
    user clicks on "Cancel", xvu_text_wait() returns NULL.  Note that
    xvu_text_wait will block the calling program until the user clicks on
    "Use" or "Cancel".

