summaryrefslogtreecommitdiff
path: root/documentation/Fl_Window.html
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/Fl_Window.html')
-rw-r--r--documentation/Fl_Window.html38
1 files changed, 23 insertions, 15 deletions
diff --git a/documentation/Fl_Window.html b/documentation/Fl_Window.html
index 183939527..cb4590cb7 100644
--- a/documentation/Fl_Window.html
+++ b/documentation/Fl_Window.html
@@ -79,25 +79,33 @@ Fl::modal()</TT></A> is zero or equal to the window. <TT>Fl_Window</TT>
</TD></TR>
</TABLE>
</CENTER>
-<H4><A name=Fl_Window.Fl_Window>Fl_Window::Fl_Window(int w, int h, const char *title = 0)</A></H4>
+<H4><A name=Fl_Window.Fl_Window>Fl_Window::Fl_Window(int w, int h, const char *title = 0)<br>
+Fl_Window::Fl_Window(int x, int y, int w, int h, const char *title = 0)</A></H4>
-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
-<tt>visible()</tt> to false and <tt>parent()</tt> to <tt>NULL</tt>.
-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 <tt>position(x,y)</tt> or <tt>hotspot()</tt>
-before calling <tt>show()</tt>.
+<p>Creates a new window. If <a
+href='Fl_Group.html#Fl_Group.current'><tt>Fl_Group::current()</tt></a>
+is not <tt>NULL</tt>, the window is created as a subwindow of
+the parent window.</p>
-<P><TT>Fl_Widget::box()</TT> is set to <TT>FL_FLAT_BOX</TT>. If you
-plan to completely fill the window with children widgets you should
-change this to <TT>FL_NO_BOX</TT>. If you turn the window border off
-you may want to change this to <TT>FL_UP_BOX</TT>. </P>
+<p>The first form of the constructor creates a top-level window
+and tells the window manager to position the window. The second
+form of the constructor either creates a subwindow or a
+top-level window at the specified location, subject to window
+manager configuration. If you do not specify the position of the
+window, the window manager will pick a place to show the window
+or allow the user to pick a location. Use <tt>position(x,y)</tt>
+or <tt>hotspot()</tt> before calling <tt>show()</tt> to force a
+position on the screen.</p>
-<h4>Fl_Window::Fl_Window(int x, int y, int w, int h, const char *title = 0)</H4>
+<p>Top-level windows initially have <tt>visible()</tt> set to 0
+and <tt>parent()</tt> set to <tt>NULL</tt>. Subwindows initially
+have <tt>visible()</tt> set to 1 and <tt>parent()</tt> set to
+the parent window pointer.</p>
-<P>The second form of the constructor is for creating child windows. It
-leaves <tt>visible()</tt> set to true.
+<P><TT>Fl_Widget::box()</TT> defaults to <TT>FL_FLAT_BOX</TT>. If you
+plan to completely fill the window with children widgets you should
+change this to <TT>FL_NO_BOX</TT>. If you turn the window border off
+you may want to change this to <TT>FL_UP_BOX</TT>.</P>
<H4><A name=Fl_Window.~Fl_Window>virtual Fl_Window::~Fl_Window()</A></H4>
The destructor <I>also deletes all the children</I>. This allows a