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

	example programs using the xvwidgets lib 

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

01.buttons_n_labels/

     This example program puts up 5 pairs of labels & buttons.
     It adds very simple callbacks to the buttons, where client_data is used
     to pass the value of an integer.


02.lists/

     This program puts up two list objects; it emphasizes the compound nature 
     of the list object which consists of a scrolled backplane and the actual
     list object.

     The xvw_change_list() routine is used to set the lists' contents; 
     passing different values for the last argument to xvw_change_list 
     determine whether a scrollbar will appear.  

     A very simple callback is added to the list items, which prints out the 
     index and string associated with a list item when the user selects it.

     This example also serves to illustrate the use of call_data.

03.menubutton/

     This program illustrates the use of the menubutton object; it 
     emphasizes the compound nature of the menubutton object, which consists 
     of the menu button itself, plus the submenu which contains the buttons
     and/or labels which are displayed when the user clicks on the menubutton.

04.pixmaps/
     
     This program shows how both buttons and labels may display pixmaps rather
     than labels.  It also shows how XVW_ABOVE, XVW_BELOW, XVW_RIGHT_OF, and
     XVW_LEFT_OF can be used to lay out objects with respect to their parent.

     The program creates two labels displaying pixmaps, one in the upper right
     hand corner of the parent, and one in the upper left hand corner of the
     parent.  It creates two buttons which display pixmaps,  one in the lower 
     right hand corner of the parent, and one in the lower left hand corner of 
     the parent.  
 
     Callbacks (not using client_data) are installed on the buttons, which 
     will print out the path to the file defining the pixmap displayed on the
     button when the user clicks on the button.

05.scrollbars1/
  
     This example program puts 5 vertical scrollbars & 5 horizontal
     scrollbars.  It adds callbacks to the scrollbars to print the value
     currently indicated by the scrollbar.  This example also serves to
     illustrate the use of call_data.  (see 06.scrollbars2 for another 
     scrollbar example)

06.scrollbars2/

    Here is another example demonstrates the use of scrollbars; it uses both 
    client_data and call_data.  
  
    The program creates two vertical scrollbars, and installs
    a callback on each which will cause the other scrollbar to
    change it's value by the same amount in the opposite direction
    when one of the scrollbars is moved.  

   
07.textstrings/

     This example creates four variations on the text object which display
     editable and non-editable text strings:
       1- editable, singleline
          NOTE: This text object does not add any action to deal with a <cr>
		on the Athena and Olit widget sets the <cr> will action create
		a new line XVW_TEXT_MULTILINE is FALSE you will not get a scroll
                bar.  You can use the cursor keys to switch to the line above
		or below.
       2- editable, multiline
	  NOTE: Under OSF/1 3.2 the text is shifted to the left and is
                obscured.
       3- noneditable, singleline
       4- noneditable, multiline
	  NOTE: Under OSF/1 3.2 the text is shifted to the left and is
                obscured.

08.textfile/

    This program creates a large text object in which a file is displayed.

09.colorbutton/
  
    This program demonstrates creation of a button, installing a
    callback on the button that passes a structure as the client_data.
  
    It creates a button in a background color, labelled with the color
    of the background.  On each button click, it changes the color of
    the background and the label accordingly.

    NOTE: In Olit the first Yellow button that is displayed will not have
	  the text Yellow in it.  If you cycle through the buttons all the
	  text will be displayed.  All other widget sets work fine.

10.create_glyph/

    This example shows how a glyph might be created in cantata.

11.toplevel/

    This example shows how to popup a toplevel in conjunction with a button
    press
