FL/Fl_Adjuster.H

   1 //
   2 // "$Id: Fl_Adjuster.H 7981 2010-12-08 23:53:04Z greg.ercolano $"
   3 //
   4 // Adjuster widget 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_Adjuster widget . */
  30
  31 // 3-button "slider", made for Nuke
  32
  33 #ifndef Fl_Adjuster_H
  34 #define Fl_Adjuster_H
  35
  36 #ifndef Fl_Valuator_H
  37 #include "Fl_Valuator.H"
  38 #endif
  39
  40 /**
  41   The Fl_Adjuster widget was stolen from Prisms, and has proven
  42   to be very useful for values that need a large dynamic range.
  43   \image html adjuster1.png
  44   \image latex adjuster1.png "Fl_Adjuster" width=4cm
  45   <P>When you  press a button and drag to the right the value increases.
  46   When you drag  to the left it decreases.  The largest button adjusts by
  47   100 *  step(), the next by 10 * step() and that
  48   smallest button  by step().  Clicking on the buttons
  49   increments by 10 times the  amount dragging by a pixel does. Shift +
  50   click decrements by 10 times  the amount.
  51 */
  52 class FL_EXPORT Fl_Adjuster : public Fl_Valuator {
  53   int drag;
  54   int ix;
  55   int soft_;
  56 protected:
  57   void draw();
  58   int handle(int);
  59   void value_damage();
  60 public:
  61   Fl_Adjuster(int X,int Y,int W,int H,const char *l=0);
  62   /**
  63     If "soft" is turned on, the user is allowed to drag the value outside
  64     the range.  If they drag the value to one of the ends, let go, then
  65     grab again and continue to drag, they can get to any value.  Default is
  66     one.
  67   */
  68   void soft(int s) {soft_ = s;}
  69   /**
  70     If "soft" is turned on, the user is allowed to drag the value outside
  71     the range.  If they drag the value to one of the ends, let go, then
  72     grab again and continue to drag, they can get to any value.  Default is
  73     one.
  74   */
  75   int soft() const {return soft_;}
  76 };
  77
  78 #endif
  79
  80 //
  81 // End of "$Id: Fl_Adjuster.H 7981 2010-12-08 23:53:04Z greg.ercolano $".
  82 //