Added Fl_Scroll::bbox() documentation (STR #1893)

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6654 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 10 insertions, 0 deletions

diff --git a/src/Fl_Scroll.cxx b/src/Fl_Scroll.cxx
index 160a84fbe..77c35d7a4 100644
--- a/src/Fl_Scroll.cxx
+++ b/src/Fl_Scroll.cxx
@@ -92,6 +92,16 @@ void Fl_Scroll::draw_clip(void* v,int X, int Y, int W, int H) {
   fl_pop_clip();
 }
 
+/**
+  Returns the bounding box for the interior of the scrolling area, inside
+  the scrollbars.
+  
+  Currently this is only reliable after draw(), and before any resizing of
+  the Fl_Scroll or any child widgets occur.
+  
+  \todo The visibility of the scrollbars ought to be checked/calculated
+  outside of the draw() method (STR #1895).
+*/
 void Fl_Scroll::bbox(int& X, int& Y, int& W, int& H) {
   X = x()+Fl::box_dx(box());
   Y = y()+Fl::box_dy(box());