docs/doxygen/overviews/bookctrl.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        bookctrl.h
   3 // Purpose:     topic overview
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10
  11 @page overview_bookctrl wxBookCtrl Overview
  12
  13 Classes:
  14
  15 @li wxChoicebook
  16 @li wxListbook
  17 @li wxNotebook
  18 @li wxTreebook
  19 @li wxToolbook
  20
  21 Sections:
  22
  23 @li @ref overview_bookctrl_intro
  24 @li @ref overview_bookctrl_bestbookctrl
  25
  26
  27 <hr>
  28
  29
  30 @section overview_bookctrl_intro Introduction
  31
  32 A book control is a convenient way of displaying multiple pages of information,
  33 displayed one page at a time. wxWidgets has five variants of this control:
  34
  35 @li wxChoicebook: controlled by a wxChoice
  36 @li wxListbook: controlled by a wxListCtrl
  37 @li wxNotebook: uses a row of tabs
  38 @li wxTreebook: controlled by a wxTreeCtrl
  39 @li wxToolbook: controlled by a wxToolBar
  40
  41 See the @ref page_samples_notebook for an example of wxBookCtrl usage.
  42
  43
  44 @section overview_bookctrl_bestbookctrl Best Book
  45
  46 wxBookCtrl is mapped to the class best suited for a given platform. Currently
  47 it provides wxChoicebook for smartphones equipped with WinCE, and wxNotebook
  48 for all other platforms. The mapping consists of:
  49
  50 @beginTable
  51 @row2col{ wxBookCtrl, wxChoicebook or wxNotebook }
  52 @row2col{ wxBookCtrlEvent, wxChoicebookEvent or wxNotebookEvent }
  53 @row2col{ wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGED,
  54     wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGED or
  55     wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED }
  56 @row2col{ wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGING,
  57     wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING or
  58     wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING }
  59 @row2col{ EVT_BOOKCTRL_PAGE_CHANGED(id\, fn),
  60     EVT_CHOICEBOOK_PAGE_CHANGED(id, fn) or
  61     EVT_NOTEBOOK_PAGE_CHANGED(id, fn) }
  62 @row2col{ EVT_BOOKCTRL_PAGE_CHANGING(id\, fn),
  63     EVT_CHOICEBOOK_PAGE_CHANGING(id, fn) or
  64     EVT_NOTEBOOK_PAGE_CHANGING(id, fn) }
  65 @endTable
  66
  67 For orientation of the book controller, use following flags in style:
  68
  69 @li @b wxBK_TOP: controller above pages
  70 @li @b wxBK_BOTTOM: controller below pages
  71 @li @b wxBK_LEFT: controller on the left
  72 @li @b wxBK_RIGHT: controller on the right
  73 @li @b wxBK_DEFAULT: native controller placement
  74
  75 */
  76