| DRC | 2ff39b8 | 2011-07-28 08:38:59 +0000 | [diff] [blame] | 1 | // |
| 2 | // "$Id: Fl_Tabs.H 8101 2010-12-22 13:06:03Z AlbrechtS $" |
| 3 | // |
| 4 | // Tab 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_Tabs widget . */ |
| 30 | |
| 31 | #ifndef Fl_Tabs_H |
| 32 | #define Fl_Tabs_H |
| 33 | |
| 34 | #include "Fl_Group.H" |
| 35 | |
| 36 | /** |
| 37 | The Fl_Tabs widget is the "file card tabs" |
| 38 | interface that allows you to put lots and lots of buttons and |
| 39 | switches in a panel, as popularized by many toolkits. |
| 40 | |
| 41 | \image html tabs.png |
| 42 | \image latex tabs.png "Fl_Tabs" width=8cm |
| 43 | |
| 44 | Clicking the tab makes a child visible() by calling |
| 45 | show() on it, and all other children are made invisible |
| 46 | by calling hide() on them. Usually the children are Fl_Group widgets |
| 47 | containing several widgets themselves. |
| 48 | |
| 49 | Each child makes a card, and its label() is printed |
| 50 | on the card tab, including the label font and style. The |
| 51 | selection color of that child is used to color the tab, while |
| 52 | the color of the child determines the background color of the pane. |
| 53 | |
| 54 | The size of the tabs is controlled by the bounding box of the |
| 55 | children (there should be some space between the children and |
| 56 | the edge of the Fl_Tabs), and the tabs may be placed |
| 57 | "inverted" on the bottom - this is determined by which |
| 58 | gap is larger. It is easiest to lay this out in fluid, using the |
| 59 | fluid browser to select each child group and resize them until |
| 60 | the tabs look the way you want them to. |
| 61 | */ |
| 62 | class FL_EXPORT Fl_Tabs : public Fl_Group { |
| 63 | Fl_Widget *value_; |
| 64 | Fl_Widget *push_; |
| 65 | int *tab_pos; // array of x-offsets of tabs per child + 1 |
| 66 | int *tab_width; // array of widths of tabs per child + 1 |
| 67 | int tab_count; // array size |
| 68 | int tab_positions(); // allocate and calculate tab positions |
| 69 | void clear_tab_positions(); |
| 70 | int tab_height(); |
| 71 | void draw_tab(int x1, int x2, int W, int H, Fl_Widget* o, int sel=0); |
| 72 | protected: |
| 73 | void redraw_tabs(); |
| 74 | void draw(); |
| 75 | |
| 76 | public: |
| 77 | int handle(int); |
| 78 | Fl_Widget *value(); |
| 79 | int value(Fl_Widget *); |
| 80 | Fl_Widget *push() const {return push_;} |
| 81 | int push(Fl_Widget *); |
| 82 | Fl_Tabs(int,int,int,int,const char * = 0); |
| 83 | Fl_Widget *which(int event_x, int event_y); |
| 84 | ~Fl_Tabs(); |
| 85 | void client_area(int &rx, int &ry, int &rw, int &rh, int tabh=0); |
| 86 | }; |
| 87 | |
| 88 | #endif |
| 89 | |
| 90 | // |
| 91 | // End of "$Id: Fl_Tabs.H 8101 2010-12-22 13:06:03Z AlbrechtS $". |
| 92 | // |