interface/choicebk.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        choicebk.h
   3 // Purpose:     interface of wxChoicebook
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10     @class wxChoicebook
  11     @wxheader{choicebk.h}
  12
  13     wxChoicebook is a class similar to wxNotebook, but uses a wxChoice control
  14     to show the labels instead of the tabs.
  15
  16     There is no documentation for this class yet but its usage is identical to
  17     wxNotebook (except for the features clearly related to tabs only), so
  18     please refer to that class documentation for now. You can also use the
  19     @ref page_samples_notebook to see wxChoicebook in action.
  20
  21     wxChoicebook allows the use of wxBookCtrlBase::GetControlSizer(), allowing
  22     a program to add other controls next to the choice control. This is
  23     particularly useful when screen space is restricted, as it often is when
  24     wxChoicebook is being employed.
  25
  26     @beginStyleTable
  27     @style{wxCHB_DEFAULT}
  28            Choose the default location for the labels depending on the current
  29            platform (left everywhere except Mac where it is top).
  30     @style{wxCHB_TOP}
  31            Place labels above the page area.
  32     @style{wxCHB_LEFT}
  33            Place labels on the left side.
  34     @style{wxCHB_RIGHT}
  35            Place labels on the right side.
  36     @style{wxCHB_BOTTOM}
  37            Place labels below the page area.
  38     @endStyleTable
  39
  40     @beginEventTable{wxChoicebookEvent}
  41     @event{EVT_CHOICEBOOK_PAGE_CHANGED(id, func)}
  42            The page selection was changed. Processes a
  43            wxEVT_COMMAND_LISTBOOK_PAGE_CHANGED event.
  44     @event{EVT_CHOICEBOOK_PAGE_CHANGING(id, func)}
  45            The page selection is about to be changed. Processes a
  46            wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING event. This event can be
  47            vetoed (using wxNotifyEvent::Veto()).
  48     @endEventTable
  49
  50     @library{wxcore}
  51     @category{miscwnd}
  52
  53     @see @ref overview_bookctrl, wxNotebook, @ref page_samples_notebook
  54
  55     @todo Write up wxBookCtrlBase documentation, where most of this class'
  56           functionality comes from.
  57 */
  58 class wxChoicebook : public wxBookCtrlBase
  59 {
  60 public:
  61     //@{
  62     /**
  63         Constructs a choicebook control.
  64     */
  65     wxChoicebook();
  66     wxChoicebook(wxWindow* parent, wxWindowID id,
  67                  const wxPoint& pos = wxDefaultPosition,
  68                  const wxSize& size = wxDefaultSize,
  69                  long style = 0,
  70                  const wxString& name = wxEmptyStr);
  71     //@}
  72
  73     /**
  74         Returns the wxChoice associated with the control.
  75     */
  76     wxChoice * GetChoiceCtrl() const;
  77 };
  78