From 89ed04701a98d32596709eaeecf46fe5d78ca63e Mon Sep 17 00:00:00 2001 From: Albrecht Schlosser Date: Sat, 14 Nov 2009 17:17:18 +0000 Subject: Removed unused members width_ and height_ from Fl_Scroll (STR #2289). Removed obsolete

tags from doxygen docs (Fl_Scroll.H), fixed some typos. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6935 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- FL/Fl_Scroll.H | 50 ++++++++++++++++++++++++++------------------------ 1 file changed, 26 insertions(+), 24 deletions(-) (limited to 'FL') diff --git a/FL/Fl_Scroll.H b/FL/Fl_Scroll.H index 5e256f41a..035a07af9 100644 --- a/FL/Fl_Scroll.H +++ b/FL/Fl_Scroll.H @@ -36,22 +36,24 @@ /** This container widget lets you maneuver around a set of widgets much - larger than your window. If the child widgets are larger than the size + larger than your window. If the child widgets are larger than the size of this object then scrollbars will appear so that you can scroll over to them: -

\image html Fl_Scroll.gif

+ \image html Fl_Scroll.gif \image latex Fl_Scroll.eps "Fl_Scroll" width=4cm -

If all of the child widgets are packed together into a solid + + If all of the child widgets are packed together into a solid rectangle then you want to set box() to FL_NO_BOX or one of the _FRAME types. This will result in the best output. - However, if the child widgets are a sparse arrangment you must set - box() to a real _BOX type. This can result in some + However, if the child widgets are a sparse arrangement you must + set box() to a real _BOX type. This can result in some blinking during redrawing, but that can be solved by using a - Fl_Double_Window.

+ Fl_Double_Window. By default you can scroll in both directions, and the scrollbars disappear if the data will fit in the area of the scroll. -

Use Fl_Scroll::type() to change this as follows : + + Use Fl_Scroll::type() to change this as follows :

-

Use scrollbar.align(int) ( see void Fl_Widget::align(Fl_Align) ) : - to change what side the scrollbars are drawn on.
If the - FL_ALIGN_LEFT bit is on, the vertical scrollbar is on the left. + Use scrollbar.align(int) ( see void Fl_Widget::align(Fl_Align) ) : + to change what side the scrollbars are drawn on. + + If the FL_ALIGN_LEFT bit is on, the vertical scrollbar is on the left. If the FL_ALIGN_TOP bit is on, the horizontal scrollbar is on the top. Note that only the alignment flags in scrollbar are considered. The flags in hscrollbar however are ignored. -

This widget can also be used to pan around a single child widget - "canvas". This child widget should be of your own class, with a - draw() method that draws the contents. The scrolling is done by + This widget can also be used to pan around a single child widget + "canvas". This child widget should be of your own class, with a + draw() method that draws the contents. The scrolling is done by changing the x() and y() of the widget, so this child - must use the x() and y() to position it's drawing. + must use the x() and y() to position its drawing. To speed up drawing it should test fl_push_clip(). -

Another very useful child is a single - Fl_Pack, which is itself a group that packs it's children - together and changes size to surround them. Filling the Fl_Pack - with Fl_Tabs groups (and then putting + Another very useful child is a single Fl_Pack, which is itself a group + that packs its children together and changes size to surround them. + Filling the Fl_Pack with Fl_Tabs groups (and then putting normal widgets inside those) gives you a very powerful scrolling list - of individually-openable panels.

+ of individually-openable panels. + + Fluid lets you create these, but you can only lay out objects that + fit inside the Fl_Scroll without scrolling. Be sure to leave + space for the scrollbars, as Fluid won't show these either. -

Fluid lets you create these, but you can only lay out objects that - fit inside the Fl_Scroll without scrolling. Be sure to leave - space for the scrollbars, as Fluid won't show these either.

-

You cannot use Fl_Window as a child of this since the + You cannot use Fl_Window as a child of this since the clipping is not conveyed to it when drawn, and it will draw over the scrollbars and neighboring objects. */ class FL_EXPORT Fl_Scroll : public Fl_Group { int xposition_, yposition_; - int width_, height_; int oldx, oldy; int scrollbar_size_; static void hscrollbar_cb(Fl_Widget*, void*); -- cgit v1.2.3