flx_return_button

Robert S. Mallozzi
<mallozzir@cspar.uah.edu> 
http://cspar.uah.edu/~mallozzir/

1997 August



NAME
      flx_return_button

PURPOSE
      Extension of the xforms library.
      Draws a button that returns when the <Return> key is pressed. 
      Look is based on the default return button of the Motif library. 

      Three types of buttons are supported:
	  FLX_NORMAL_BUTTON	Uses an FL_UP_BOX
	  FLX_ROUNDED3D_BUTTON  Uses an FL_ROUNDED3DUPBOX
	  FLX_OVAL3D_BUTTON	Uses an FL_OVAL3D_UPBOX

CALLING SEQUENCE

      #include "flx_return_button.h"

      obj = flx_add_return_button(FLX_NORMAL_BUTTON, x, y, w, h, "label");
      obj = flx_add_return_button(FLX_ROUNDED3D_BUTTON, x, y, w, h, "label");
      obj = flx_add_return_button(FLX_OVAL3D_BUTTON, x, y, w, h, "label");

RESTRICTIONS
      Border width of the outside box is fixed at border width = -1

CLASS NUMBER
      3502

MODIFICATION HISTORY
      Written, <Robert.Mallozzi@msfc.nasa.gov>, August 1997
	  Based on the examples of new button classes in the XForms manual.


USAGE

    Compile flx_return_button.c into flx_return_button.o, and then link in
    with the rest of your XForms code.  Files that call flx_add_return_button()
    must include the header flx_return_button.h

    To compile the test program, edit Makefile if you compiler cannot find 
    the libraries

          -lforms -lX11 -lm

    Then run make.      
 
 

LEGAL

    Permission to use, copy, and distribute this software for any purpose 
    and without fee is hereby granted, provided that the author's
    name and this notice appear in all copies and in supporting documentation.
    All distributions must include the original, unmodified source code.
    If the software is modified, prominent notice of modifications 
    must be given.  The author's name shall not be otherwise used 
    publicity pertaining to distribution of the software without specific, 
    written prior permission. 

    THE SOFTWARE IS PROVIDED TO YOU "AS-IS", AND WITHOUT WARRANTY OF ANY KIND, 
    EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY 
    OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT SHALL 
    THE AUTHOR BE LIABLE TO YOU OR ANYONE ELSE FOR ANY DIRECT, SPECIAL, 
    INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES 
    WHATSOEVER, INCLUDING WITHOUT LIMITATION, LOSS OF PROFIT, LOSS OF USE, 
    SAVINGS OR REVENUE, OR THE CLAIMS OF THIRD PARTIES, WHETHER OR NOT THE 
    AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS, HOWEVER CAUSED 
    AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE
    POSSESSION, USE OR PERFORMANCE OF THIS SOFTWARE.

    This software is in no way affiliated with the University of Alabama,
    or NASA and the US government.    
