classic/carbon split

[wxWidgets.git] / docs / latex / wx / tsizer.tex

diff --git a/docs/latex/wx/tsizer.tex b/docs/latex/wx/tsizer.tex
index ba9483a39414910d461d966181ed3842a93465c5..1a21f8fb1435f83d545acea51b8396232e3c4136 100644 (file)
--- a/docs/latex/wx/tsizer.tex
+++ b/docs/latex/wx/tsizer.tex
@@ -12,7 +12,7 @@ define the layout of controls in dialogs in wxWindows because of
 their ability to create visually appealing dialogs independent of the
 platform, taking into account the differences in size and style of
 the individual controls. Unlike the original wxWindows Dialog Editor,
 their ability to create visually appealing dialogs independent of the
 platform, taking into account the differences in size and style of
 the individual controls. Unlike the original wxWindows Dialog Editor,

-editors such as wxDesigner, wxrcedit, XRCed and wxWorkshop create dialogs based exclusively on sizers,
+editors such as wxDesigner, DialogBlocks, wxrcedit, XRCed and wxWorkshop create dialogs based exclusively on sizers,

 practically forcing the user to create platform independent layouts without compromises.
 
 The next section describes and shows what can be done with sizers.
 practically forcing the user to create platform independent layouts without compromises.
 
 The next section describes and shows what can be done with sizers.


@@ -113,6 +113,21 @@ initial width:
 
 Within wxDesigner, this stretch factor gets set from the {\it Option} menu.
 
 
 Within wxDesigner, this stretch factor gets set from the {\it Option} menu.
 

+\subsubsection{Hiding controls using sizers}\label{sizershiding}
+
+You can hide controls contained in sizers the same way you would hide any control,
+using the \helpref{wxWindow::Show}{wxwindowshow} method.
+
+However, wxSizer also offers a separate method which can tell the sizer not to 
+consider that control in its size calculations.  To hide a window using the sizer,
+call \helpref{wxSizer::Show}{wxsizershow}.  You must then call Layout on the sizer 
+to force an update.
+
+This is useful when hiding parts of the interface, since you can avoid removing
+the controls from the sizer and having to add them back later.
+
+Note: This is supported only by wxBoxSizer and wxFlexGridSizer.
+

 \wxheading{wxBoxSizer}
 
 \helpref{wxBoxSizer}{wxboxsizer} can lay out its children either vertically
 \wxheading{wxBoxSizer}
 
 \helpref{wxBoxSizer}{wxboxsizer} can lay out its children either vertically