Improve and reorganize Fl_Tile's documentation and test/tile demo.

Moved docs from header file and enhanced docs, particularly about the
resizable() widget and the resize behavior in general.

Changed the tile demo program to use a resizable() with 20 pixels
border distance, so that border dragging is limited as described in the
docs. Updated the image file to reflect the current test/tile.cxx demo.


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

1 files changed, 16 insertions, 6 deletions

diff --git a/test/tile.cxx b/test/tile.cxx
index 088ce08b5..614fd7c67 100644
--- a/test/tile.cxx
+++ b/test/tile.cxx
@@ -3,7 +3,7 @@
 //
 // Tile test program for the Fast Light Tool Kit (FLTK).
 //
-// Copyright 1998-2010 by Bill Spitzak and others.
+// Copyright 1998-2014 by Bill Spitzak and others.
 //
 // This library is free software. Distribution and use rights are outlined in
 // the file "COPYING" which should have been included with this file.  If this
@@ -27,19 +27,23 @@ int main(int argc, char** argv) {
   Fl_Double_Window window(300,300);
   window.box(FL_NO_BOX);
   window.resizable(window);
+
+  int dx = 20, dy = dx; // border width of resizable() - see below
   Fl_Tile tile(0,0,300,300);
+
   Fl_Box box0(0,0,150,150,"0");
   box0.box(FL_DOWN_BOX);
   box0.color(9);
   box0.labelsize(36);
   box0.align(FL_ALIGN_CLIP);
+
   Fl_Double_Window w1(150,0,150,150,"1");
   w1.box(FL_NO_BOX);
-  Fl_Box box1(0,0,150,150,"1\nThis is a\nchild\nwindow");
+  Fl_Box box1(0,0,150,150,"1\nThis is a child window");
   box1.box(FL_DOWN_BOX);
   box1.color(19);
   box1.labelsize(18);
-  box1.align(FL_ALIGN_CLIP);
+  box1.align(FL_ALIGN_CLIP|FL_ALIGN_INSIDE|FL_ALIGN_WRAP);
   w1.resizable(box1);
   w1.end();
 
@@ -49,6 +53,7 @@ int main(int argc, char** argv) {
   box2a.color(12);
   box2a.labelsize(36);
   box2a.align(FL_ALIGN_CLIP);
+
   Fl_Box box2b(70,150,80,150,"2b");
   box2b.box(FL_DOWN_BOX);
   box2b.color(13);
@@ -62,22 +67,27 @@ int main(int argc, char** argv) {
   box3a.color(12);
   box3a.labelsize(36);
   box3a.align(FL_ALIGN_CLIP);
+
   Fl_Box box3b(150,150+70,150,80,"3b");
   box3b.box(FL_DOWN_BOX);
   box3b.color(13);
   box3b.labelsize(36);
   box3b.align(FL_ALIGN_CLIP);
   //tile3.end();
-  
-  Fl_Box r(10,0,300-10,300-10);
+
+  // create the symmetrical resize box with dx and dy pixels distance, resp.
+  // from the borders of the Fl_Tile widget
+  Fl_Box r(tile.x()+dx,tile.y()+dy,tile.w()-2*dx,tile.h()-2*dy);
   tile.resizable(r);
   // r.box(FL_BORDER_FRAME);
 
   tile.end();
   window.end();
-#ifdef TEST_INACTIVE // test inactive case 
+
+#ifdef TEST_INACTIVE // test inactive case
   tile.deactivate();
 #endif
+
   w1.show();
   window.show(argc,argv);
   return Fl::run();