FL/Fl_Positioner.H

   1 //
   2 // "$Id: Fl_Positioner.H 7981 2010-12-08 23:53:04Z greg.ercolano $"
   3 //
   4 // Positioner header file for the Fast Light Tool Kit (FLTK).
   5 //
   6 // Copyright 1998-2010 by Bill Spitzak and others.
   7 //
   8 // This library is free software; you can redistribute it and/or
   9 // modify it under the terms of the GNU Library General Public
  10 // License as published by the Free Software Foundation; either
  11 // version 2 of the License, or (at your option) any later version.
  12 //
  13 // This library is distributed in the hope that it will be useful,
  14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 // Library General Public License for more details.
  17 //
  18 // You should have received a copy of the GNU Library General Public
  19 // License along with this library; if not, write to the Free Software
  20 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21 // USA.
  22 //
  23 // Please report all bugs and problems on the following page:
  24 //
  25 //     http://www.fltk.org/str.php
  26 //
  27
  28 /* \file
  29    Fl_Positioner widget . */
  30
  31 #ifndef Fl_Positioner_H
  32 #define Fl_Positioner_H
  33
  34 #ifndef Fl_Widget_H
  35 #include "Fl_Widget.H"
  36 #endif
  37
  38 /**
  39   This class is provided for Forms compatibility.  It provides 2D input.
  40   It would be useful if this could be put atop another widget so that the
  41   crosshairs are on top, but this is not implemented.  The color of the
  42   crosshairs is selection_color().
  43   <P ALIGN=CENTER>\image html  positioner.png </P>
  44   \image latex  positioner.png " Fl_Positioner" width=4cm
  45 */
  46 class FL_EXPORT Fl_Positioner : public Fl_Widget {
  47
  48   double xmin, ymin;
  49   double xmax, ymax;
  50   double xvalue_, yvalue_;
  51   double xstep_, ystep_;
  52
  53 protected:
  54
  55   // these allow subclasses to put the dial in a smaller area:
  56   void draw(int, int, int, int);
  57   int handle(int, int, int, int, int);
  58   void draw();
  59
  60 public:
  61
  62   int handle(int);
  63   /**
  64     Creates a new Fl_Positioner widget using the given position,
  65     size, and label string. The default boxtype is FL_NO_BOX.
  66   */
  67   Fl_Positioner(int x,int y,int w,int h, const char *l=0);
  68   /** Gets the X axis coordinate.*/
  69   double xvalue() const {return xvalue_;}
  70   /** Gets the Y axis coordinate.*/
  71   double yvalue() const {return yvalue_;}
  72   int xvalue(double);
  73   int yvalue(double);
  74   int value(double,double);
  75   void xbounds(double, double);
  76   /** Gets the X axis minimum */
  77   double xminimum() const {return xmin;}
  78   /** Same as xbounds(a, xmaximum()) */
  79   void xminimum(double a) {xbounds(a,xmax);}
  80   /** Gets the X axis maximum */
  81   double xmaximum() const {return xmax;}
  82   /** Same as xbounds(xminimum(), a) */
  83   void xmaximum(double a) {xbounds(xmin,a);}
  84   void ybounds(double, double);
  85   /** Gets the Y axis minimum */
  86   double yminimum() const {return ymin;}
  87   /** Same as ybounds(a, ymaximum()) */
  88   void yminimum(double a) {ybounds(a, ymax);}
  89   /** Gets the Y axis maximum */
  90   double ymaximum() const {return ymax;}
  91   /** Same as ybounds(ymininimum(), a) */
  92   void ymaximum(double a) {ybounds(ymin, a);}
  93   /** Sets the stepping value for the X axis.*/
  94   void xstep(double a) {xstep_ = a;}
  95   /** Sets the stepping value for the Y axis.*/
  96   void ystep(double a) {ystep_ = a;}
  97 };
  98
  99 #endif
 100
 101 //
 102 // End of "$Id: Fl_Positioner.H 7981 2010-12-08 23:53:04Z greg.ercolano $".
 103 //