| DRC | 2ff39b8 | 2011-07-28 08:38:59 +0000 | [diff] [blame] | 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 | // |