docs/latex/wx/tbook.tex

   1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   2 %% Name:        tbook.tex
   3 %% Purpose:     wxBookCtrl overview
   4 %% Author:      Wlodzimierz ABX Skiba
   5 %% Modified by:
   6 %% Created:     11/18/2004
   7 %% RCS-ID:      $Id$
   8 %% Copyright:   (c) wxWidgets team
   9 %% License:     wxWindows license
  10 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  11
  12 \section{wxBookCtrl overview}\label{wxbookctrloverview}
  13
  14 Classes: \helpref{wxNotebook}{wxnotebook}, \helpref{wxListbook}{wxlistbook}, \helpref{wxChoicebook}{wxchoicebook}
  15
  16 \subsection{Introduction}\label{wxbookctrlintro}
  17
  18 A book control is a convenient way of displaying multiple pages of information,
  19 displayed one page at a time. wxWidgets has three variants of this control:
  20
  21 \begin{itemize}\itemsep=0pt
  22 \item \helpref{wxNotebook}{wxnotebook}: uses a row of tabs
  23 \item \helpref{wxListbook}{wxlistbook}: controlled by a \helpref{wxListCtrl}{wxlistctrl}
  24 \item \helpref{wxChoicebook}{wxchoicebook}: controlled by a \helpref{wxChoice}{wxchoice}
  25 \end{itemize}
  26
  27 \subsection{Best book}\label{wxbestbookctrl}
  28
  29 wxBookCtrl is mapped to the class best suited for a given platform.
  30 Currently it provides \helpref{wxChoicebook}{wxchoicebook} for smartphones equipped with
  31 WinCE, and \helpref{wxNotebook}{wxnotebook} for all other platforms. The mapping consists of:
  32
  33 \twocolwidtha{5cm}
  34 \begin{twocollist}\itemsep=0pt
  35 \twocolitem{wxBookCtrl}{wxChoicebook or wxNotebook}
  36 \twocolitem{wxBookCtrlEvent}{wxChoicebookEvent or wxNotebookEvent}
  37 \twocolitem{wxEVT\_COMMAND\_BOOKCTRL\_PAGE\_CHANGED}{wxEVT\_COMMAND\_CHOICEBOOK\_PAGE\_CHANGED or wxEVT\_COMMAND\_NOTEBOOK\_PAGE\_CHANGED}
  38 \twocolitem{wxEVT\_COMMAND\_BOOKCTRL\_PAGE\_CHANGING}{wxEVT\_COMMAND\_CHOICEBOOK\_PAGE\_CHANGING or wxEVT\_COMMAND\_NOTEBOOK\_PAGE\_CHANGING}
  39 \twocolitem{EVT\_BOOKCTRL\_PAGE\_CHANGED(id, fn)}{EVT\_CHOICEBOOK\_PAGE\_CHANGED(id, fn) or EVT\_NOTEBOOK\_PAGE\_CHANGED(id, fn)}
  40 \twocolitem{EVT\_BOOKCTRL\_PAGE\_CHANGING(id, fn)}{EVT\_CHOICEBOOK\_PAGE\_CHANGING(id, fn) or EVT\_NOTEBOOK\_PAGE\_CHANGING(id, fn)}
  41 \twocolitem{\windowstyle{wxBC\_TOP}}{\windowstyle{wxCHB\_TOP} or \windowstyle{wxNB\_TOP}}
  42 \twocolitem{\windowstyle{wxBC\_BOTTOM}}{\windowstyle{wxCHB\_BOTTOM} or \windowstyle{wxNB\_BOTTOM}}
  43 \twocolitem{\windowstyle{wxBC\_LEFT}}{\windowstyle{wxCHB\_LEFT} or \windowstyle{wxNB\_LEFT}}
  44 \twocolitem{\windowstyle{wxBC\_RIGHT}}{\windowstyle{wxCHB\_RIGHT} or \windowstyle{wxNB\_RIGHT}}
  45 \twocolitem{\windowstyle{wxBC\_DEFAULT}}{\windowstyle{wxCHB\_DEFAULT} or \windowstyle{wxNB\_DEFAULT}}
  46 \end{twocollist}
  47
  48 See {\tt samples/widgets} for an example of wxBookCtrl usage.
  49