summaryrefslogtreecommitdiff
path: root/FL/Fl_Tabs.H
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2020-07-01 18:03:10 +0200
committerAlbrecht Schlosser <albrechts.fltk@online.de>2020-07-06 20:28:20 +0200
commitf09e17c3c564e8310125a10c03397cbf473ff643 (patch)
tree8d0fd4a28e3686c33aaa140d07ddba26ab28bdc2 /FL/Fl_Tabs.H
parentb0e0c355edaa2e23148cb0260ada907aec930f05 (diff)
Remove $Id$ tags, update URL's, and more
- remove obsolete svn '$Id$' tags from all source files - update .fl files and generated files accordingly - replace 'http://www.fltk.org' URL's with 'https://...' - replace bug report URL 'str.php' with 'bugs.php' - remove trailing whitespace - fix other whitespace errors flagged by Git - add and/or fix missing or wrong standard headers - convert tabs to spaces in all source files The only relevant code changes are in the fluid/ folder where some .fl files and other source files were used to generate the '$Id' headers and footers.
Diffstat (limited to 'FL/Fl_Tabs.H')
-rw-r--r--FL/Fl_Tabs.H58
1 files changed, 26 insertions, 32 deletions
diff --git a/FL/Fl_Tabs.H b/FL/Fl_Tabs.H
index dd0820418..eadeb8999 100644
--- a/FL/Fl_Tabs.H
+++ b/FL/Fl_Tabs.H
@@ -1,6 +1,4 @@
//
-// "$Id$"
-//
// Tab header file for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2017 by Bill Spitzak and others.
@@ -9,11 +7,11 @@
// the file "COPYING" which should have been included with this file. If this
// file is missing or damaged, see the license at:
//
-// http://www.fltk.org/COPYING.php
+// https://www.fltk.org/COPYING.php
//
-// Please report all bugs and problems on the following page:
+// Please see the following page on how to report bugs and issues:
//
-// http://www.fltk.org/str.php
+// https://www.fltk.org/bugs.php
//
/* \file
@@ -28,22 +26,22 @@
The Fl_Tabs widget is the "file card tabs"
interface that allows you to put lots and lots of buttons and
switches in a panel, as popularized by many toolkits.
-
+
\image html tabs.png
\image latex tabs.png "Fl_Tabs" width=8cm
-
+
Clicking the tab makes a child visible() by calling
show() on it, and all other children are made invisible
by calling hide() on them. Usually the children are Fl_Group widgets
containing several widgets themselves.
-
+
Each child makes a card, and its label() is printed
on the card tab, including the label font and style. The
selection color of that child is used to color the tab, while
the color of the child determines the background color of the pane.
'&' in labels are used to prefix a shortcut that is drawn underlined and
that activates the corresponding tab; repeated '&&' avoids that.
-
+
The size of the tabs is controlled by the bounding box of the
children (there should be some space between the children and
the edge of the Fl_Tabs), and the tabs may be placed
@@ -51,7 +49,7 @@
gap is larger. It is easiest to lay this out in fluid, using the
fluid browser to select each child group and resize them until
the tabs look the way you want them to.
-
+
The background area behind and to the right of the tabs is
"transparent", exposing the background detail of the parent. The
value of Fl_Tabs::box() does not affect this area. So if Fl_Tabs is
@@ -70,15 +68,15 @@
Fl_Tabs *tabs = new Fl_Tabs(10,10,300,200);
{
Fl_Group *grp1 = new Fl_Group(20,30,280,170,"Tab1");
- {
- ..widgets that go in tab#1..
+ {
+ ..widgets that go in tab#1..
}
- grp1->end();
+ grp1->end();
Fl_Group *grp2 = new Fl_Group(20,30,280,170,"Tab2");
- {
- ..widgets that go in tab#2..
- }
- grp2->end();
+ {
+ ..widgets that go in tab#2..
+ }
+ grp2->end();
}
tabs->end();
\endcode
@@ -115,7 +113,7 @@
\b Uniform \b Tab \b and \b Panel \b Appearance
In order to have uniform tab and panel appearance, not only must the color()
- and selection_color() for each child group be set, but also the
+ and selection_color() for each child group be set, but also the
selection_color() of the Fl_Tab itself any time a new "tab" is selected.
This can be achieved within the Fl_Tab callback, e.g.
@@ -174,7 +172,7 @@
grp2 = new Fl_Group(..);
..
tabs->end();
- tabs->resizable(grp1); // keeps tab height constant
+ tabs->resizable(grp1); // keeps tab height constant
\endcode
\par Callback's Use Of when()
@@ -190,15 +188,15 @@
-# The above flags can be logically OR-ed (|) or added (+) to combine behaviors.
-# The default value for when() is \ref FL_WHEN_RELEASE (inherited from Fl_Widget).
- -# If \ref FL_WHEN_RELEASE is the \em only flag specified,
+ -# If \ref FL_WHEN_RELEASE is the \em only flag specified,
the behavior will be as if (\ref FL_WHEN_RELEASE|\ref FL_WHEN_CHANGED) was specified.
-# The value of changed() will be valid during the callback.
- -# If both \ref FL_WHEN_CHANGED and \ref FL_WHEN_NOT_CHANGED are specified,
+ -# If both \ref FL_WHEN_CHANGED and \ref FL_WHEN_NOT_CHANGED are specified,
the callback is invoked whether the tab has been changed or not.
- The changed() method can be used to determine the cause.
+ The changed() method can be used to determine the cause.
-# \ref FL_WHEN_NOT_CHANGED can happen if someone clicks on an already selected tab,
or if a keyboard navigation attempt results in no change to the tabs,
- such as using the arrow keys while at the left or right end of the tabs.
+ such as using the arrow keys while at the left or right end of the tabs.
*/
class FL_EXPORT Fl_Tabs : public Fl_Group {
@@ -206,13 +204,13 @@ class FL_EXPORT Fl_Tabs : public Fl_Group {
protected:
- int *tab_pos; // array of x-offsets of tabs per child + 1
- int *tab_width; // array of widths of tabs per child + 1
- int tab_count; // array size
- Fl_Align tab_align_; // tab label alignment
+ int *tab_pos; // array of x-offsets of tabs per child + 1
+ int *tab_width; // array of widths of tabs per child + 1
+ int tab_count; // array size
+ Fl_Align tab_align_; // tab label alignment
virtual void redraw_tabs();
- virtual int tab_positions(); // allocate and calculate tab positions
+ virtual int tab_positions(); // allocate and calculate tab positions
virtual void clear_tab_positions();
virtual void draw_tab(int x1, int x2, int W, int H, Fl_Widget* o, int sel=0);
virtual int tab_height();
@@ -267,7 +265,3 @@ public:
};
#endif
-
-//
-// End of "$Id$".
-//