added null pointer check and assert

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

diff --git a/docs/latex/wx/ttab.tex b/docs/latex/wx/ttab.tex
index 33eee2ab3ecc2bd4546b2fb28bb62c8922f45194..b3b4112c82e2329664af130d7bae210d67c6c5aa 100644 (file)
--- a/docs/latex/wx/ttab.tex
+++ b/docs/latex/wx/ttab.tex
@@ -1,7 +1,7 @@
-\section{Tab classes overview}\label{wxtaboverview}
+\section{wxTab classes overview}\label{wxtaboverview}
 
 Classes: \helpref{wxTabView}{wxtabview}, \helpref{wxPanelTabView}{wxpaneltabview},
- \helpref{wxTabbedPanel}{wxtabbedpanel}, \helpref{wxTabbedDialogBox}{wxtabbeddialogbox},
+ \helpref{wxTabbedPanel}{wxtabbedpanel}, \helpref{wxTabbedDialog}{wxtabbeddialog},
  \helpref{wxTabControl}{wxtabcontrol}
 
 The tab classes provides a way to display rows of tabs (like file divider tabs), which can be
@@ -9,7 +9,11 @@ used to switch between panels or other information. Tabs are most
 commonly used in dialog boxes where the number of options is too great
 to fit on one dialog.
 
-\wxheading{The appearance and behaviour of a wxTabbedDialogBox}
+{\bf Please note} that the preferred class for programming tabbed windows is \helpref{wxNotebook}{wxnotebook}.
+The old tab classes are retained for backward compatibility and also to implement
+wxNotebook on platforms that don't have native tab controls.
+
+\wxheading{The appearance and behaviour of a wxTabbedDialog}
 
 The following screenshot shows the appearance of the sample tabbed dialog application.
 
@@ -108,7 +112,7 @@ void MyDialog::Init(void)
   // Calculate the tab width for 4 tabs, based on a view width of 326 and
   // the current horizontal spacing. Adjust the view width to exactly fit
   // the tabs.
-  view->CalculateTabWidth(4, TRUE);
+  view->CalculateTabWidth(4, true);
 
   if (!view->AddTab(TEST_TAB_CAT,        wxString("Cat")))
     return;
@@ -165,39 +169,6 @@ void MyDialog::Init(void)
 \end{verbatim}
 }
 
-\subsection{wxTab change log}
-
-June 3rd 1997, Version 1.2
-
-\begin{itemize}\itemsep=0pt
-\item Fixed bug which drew some tabs incorrectly.
-\item Altered sample to put buttons below tabs, as per standard
-Windows conventions.
-\item Added improvements from Hitachi Europe Limited: draws correctly
-on Motif and Windows, and tabs are now rounded - much nicer.
-\end{itemize}
-
-April 29th 1996, Version 1.1
-
-\begin{itemize}\itemsep=0pt
-\item Added SetHorizontalTabOffset, SetHorizontalTabSpacing.
-\item Corrected bug in colouring tabs (1 pixel out).
-\item Corrected bug in adding tabs: last tab on first row could overlap right-hand
-edge.
-\item Added Layout function to allow resizing of the view rectangle and subsequent redrawing
-of the tabs.
-\item Added WXTAB\_VERSION symbol.
-\item Fixed bug in SetTabSelection which did not move the selected tab to the first row.
-\item Added argument in SetTabSelection to optionally avoid calling activation code.
-\item Changed wxPanelTabView API to allow use of any window, not just a panel, in a tab.
-\end{itemize}
-
-April 24th 1996, Version 1.0
-
-\begin{itemize}\itemsep=0pt
-\item First release.
-\end{itemize}
-
 \section{wxTabView overview}\label{wxtabviewoverview}
 
 Classes: \helpref{wxTabView}{wxtabview}, \helpref{wxPanelTabView}{wxpaneltabview}
@@ -209,7 +180,7 @@ wxPanelTabView class, but an application could derive other kinds of
 view from wxTabView. 
 
 For example, a help application might draw a representation of a book on
-a canvas, with a row of tabs along the top. The new tab view class might
+a window, with a row of tabs along the top. The new tab view class might
 be called wxCanvasTabView, for example, with the wxBookCanvas posting
 the OnEvent function to the wxCanvasTabView before processing further,
 application-specific event processing.