better documentation for wxWindow::SetSizerAndFit()

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@51178 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/docs/latex/wx/sizer.tex b/docs/latex/wx/sizer.tex
index 36c801e15272c01c7da570e006512ee02a3c8fdd..0c8b32a5b04300695d398608b7c0caf13edb9490 100644 (file)
--- a/docs/latex/wx/sizer.tex
+++ b/docs/latex/wx/sizer.tex
@@ -527,10 +527,12 @@ passed to it. This only makes sense when {\it window} is actually a
 wxDialog, since SetSizeHints only has any effect in these classes. 
 It does nothing in normal windows or controls.
 
 wxDialog, since SetSizeHints only has any effect in these classes. 
 It does nothing in normal windows or controls.
 

-This method is commonly invoked in the constructor of a toplevel window itself
-(see the sample in the description of \helpref{wxBoxSizer}{wxboxsizer}) if the
+This method is implicitly used by \helpref{wxWindow::SetSizerAndFit}{wxwindowsetsizerandfit} 
+which is commonly invoked in the constructor of a toplevel window itself (see
+the sample in the description of \helpref{wxBoxSizer}{wxboxsizer}) if the

 toplevel window is resizable.
 
 toplevel window is resizable.
 

+

 \membersection{wxSizer::SetVirtualSizeHints}\label{wxsizersetvirtualsizehints}
 
 \func{void}{SetVirtualSizeHints}{\param{wxWindow* }{window}}
 \membersection{wxSizer::SetVirtualSizeHints}\label{wxsizersetvirtualsizehints}
 
 \func{void}{SetVirtualSizeHints}{\param{wxWindow* }{window}}

diff --git a/docs/latex/wx/tsizer.tex b/docs/latex/wx/tsizer.tex
index 815b7e4357f45513e51abd8e79ac3a4b7855670b..5218b51ef85357be3b56fbeecf83abcacc237d94 100644 (file)
--- a/docs/latex/wx/tsizer.tex
+++ b/docs/latex/wx/tsizer.tex
@@ -259,9 +259,9 @@ MyDialog::MyDialog(wxFrame *parent, wxWindowID id, const wxString &title )
      0,                // make vertically unstretchable
      wxALIGN_CENTER ); // no border and centre horizontally
 
      0,                // make vertically unstretchable
      wxALIGN_CENTER ); // no border and centre horizontally
 

-  SetSizer( topsizer );      // use the sizer for layout
-
-  topsizer->SetSizeHints( this );   // set size hints to honour minimum size
+  SetSizerAndFit(topsizer); // use the sizer for layout and size window
+                            // accordingly and prevent it from being resized
+                            // to smaller size

 }
 \end{verbatim}
 
 }
 \end{verbatim}
 


@@ -302,9 +302,7 @@ MyDialog::MyDialog(wxFrame *parent, wxWindowID id, const wxString &title )
      button_sizer,
      wxSizerFlags(0).Center() ); 
 
      button_sizer,
      wxSizerFlags(0).Center() ); 
 

-  SetSizer( topsizer );      // use the sizer for layout
-
-  topsizer->SetSizeHints( this );   // set size hints to honour minimum size
+  SetSizerAndFit(topsizer); // use the sizer for layout and set size and hints

 }
 \end{verbatim}
 
 }
 \end{verbatim}
 

diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex
index cf6e0c3ecab346b34e6c04dc51c7de9a8eabfb7e..2c1977bfe86e6e4da7dd4a11791ffcaa5e00109d 100644 (file)
--- a/docs/latex/wx/window.tex
+++ b/docs/latex/wx/window.tex
@@ -3594,8 +3594,11 @@ only the sizer will have effect.
 
 \func{void}{SetSizerAndFit}{\param{wxSizer* }{sizer}, \param{bool }{deleteOld=true}}
 
 
 \func{void}{SetSizerAndFit}{\param{wxSizer* }{sizer}, \param{bool }{deleteOld=true}}
 

-The same as \helpref{SetSizer}{wxwindowsetsizer}, except it also sets the size hints
-for the window based on the sizer's minimum size.
+This method calls \helpref{SetSizer}{wxwindowsetsizer} and then 
+\helpref{wxSizer::SetSizeHints}{wxsizersetsizehints} which sets the initial
+window size to the size needed to accommodate all sizer elements and sets the
+size hints which, if this window is a top level one, prevent the user from
+resizing it to be less than this minimial size.

 
 
 \membersection{wxWindow::SetThemeEnabled}\label{wxwindowsetthemeenabled}
 
 
 \membersection{wxWindow::SetThemeEnabled}\label{wxwindowsetthemeenabled}