From dc70b69502de6769c8fe109161f984494a0c00b8 Mon Sep 17 00:00:00 2001
From: Michael R Sweet
Date: Tue, 19 Jan 1999 20:53:39 +0000
Subject: Updated documentation with changes from Bill. Added new image files
for buttons.
git-svn-id: file:///fltk/svn/fltk/trunk@237 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
documentation/Fl_Window.html | 29 ++++++++++++++++++-----------
1 file changed, 18 insertions(+), 11 deletions(-)
(limited to 'documentation/Fl_Window.html')
diff --git a/documentation/Fl_Window.html b/documentation/Fl_Window.html
index bfd8a828a..f78fee9f3 100644
--- a/documentation/Fl_Window.html
+++ b/documentation/Fl_Window.html
@@ -81,23 +81,31 @@ exit(0) if this is the last top-level window.
-
- The first constructor takes 4 int arguments to create the window with
-a preset position and size. The second constructor with 2 arguments
-will create the window with a preset size, but the window manager will
-choose the position according to it's own whims.
+
+
+The first form of the constructor should be used for a "top-level" window
+(that is, one that is not inside another window). It correctly sets
+visible() to false and parent() to NULL.
+By not specifying the position of the window, the window system will pick a
+place to show the window or allow the user to pick a location. If you want to
+force a position you should call position(x,y) or hotspot()
+before calling show().
+
+The second form of the constructor is for creating child windows. It
+leaves visible() set to true.
+
Fl_Widget::box() is set to FL_FLAT_BOX. If you
plan to completely fill the window with children widgets you should
change this to FL_NO_BOX. If you turn the window border off
you may want to change this to FL_UP_BOX.
+
The destructor also deletes all the children. This allows a
whole tree to be deleted at once, without having to keep a pointer to
all the children in the user code. A kludge has been done so the
Fl_Window and all of it's children can be automatic (local)
-variables, but you must declare the Fl_Windowfirst, so
+variables, but you must declare the Fl_Window first so
that it is destroyed last.
@@ -146,8 +154,7 @@ top. This is really convenient because your program can call show()
show() serves the purpose of raise() in other toolkits.
Remove the window from the screen. If the window is already hidden or
-has not been shown then this does nothing (and is harmless). Under
-the X Window System this actually destroys the xid.
+has not been shown then this does nothing and is harmless.
Returns non-zero if show() has been called (but not hide()
). You can tell if a window is iconified with (w->shown()
@@ -254,4 +261,4 @@ debug and maintain!
This method only works for the Fl_Window and
Fl_Gl_Window classes.
- Returns the last window that was made current.