include/wx/generic/wizard.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        generic/wizard.h
   3 // Purpose:     declaration of generic wxWizard class
   4 // Author:      Vadim Zeitlin
   5 // Modified by: Robert Vazan (sizers)
   6 // Created:     28.09.99
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ----------------------------------------------------------------------------
  13 // wxWizard
  14 // ----------------------------------------------------------------------------
  15
  16 class WXDLLEXPORT wxButton;
  17 class WXDLLEXPORT wxStaticBitmap;
  18 class WXDLLIMPEXP_ADV wxWizardEvent;
  19 class WXDLLEXPORT wxBoxSizer;
  20 class WXDLLIMPEXP_ADV wxWizardSizer;
  21
  22 class WXDLLIMPEXP_ADV wxWizard : public wxWizardBase
  23 {
  24 public:
  25     // ctor
  26     wxWizard() { Init(); }
  27     wxWizard(wxWindow *parent,
  28              int id = wxID_ANY,
  29              const wxString& title = wxEmptyString,
  30              const wxBitmap& bitmap = wxNullBitmap,
  31              const wxPoint& pos = wxDefaultPosition,
  32              long style = wxDEFAULT_DIALOG_STYLE)
  33     {
  34         Init();
  35         Create(parent, id, title, bitmap, pos, style);
  36     }
  37     bool Create(wxWindow *parent,
  38              int id = wxID_ANY,
  39              const wxString& title = wxEmptyString,
  40              const wxBitmap& bitmap = wxNullBitmap,
  41              const wxPoint& pos = wxDefaultPosition,
  42              long style = wxDEFAULT_DIALOG_STYLE);
  43     void Init();
  44
  45     // implement base class pure virtuals
  46     virtual bool RunWizard(wxWizardPage *firstPage);
  47     virtual wxWizardPage *GetCurrentPage() const;
  48     virtual void SetPageSize(const wxSize& size);
  49     virtual wxSize GetPageSize() const;
  50     virtual void FitToPage(const wxWizardPage *firstPage);
  51     virtual wxSizer *GetPageAreaSizer() const;
  52     virtual void SetBorder(int border);
  53
  54     // implementation only from now on
  55     // -------------------------------
  56
  57     // is the wizard running?
  58     bool IsRunning() const { return m_page != NULL; }
  59
  60     // show the prev/next page, but call TransferDataFromWindow on the current
  61     // page first and return false without changing the page if
  62     // TransferDataFromWindow() returns false - otherwise, returns true
  63     bool ShowPage(wxWizardPage *page, bool goingForward = true);
  64
  65     // do fill the dialog with controls
  66     // this is app-overridable to, for example, set help and tooltip text
  67     virtual void DoCreateControls();
  68
  69 protected:
  70     void FinishLayout();
  71
  72 private:
  73     // was the dialog really created?
  74     bool WasCreated() const { return m_btnPrev != NULL; }
  75
  76     // event handlers
  77     void OnCancel(wxCommandEvent& event);
  78     void OnBackOrNext(wxCommandEvent& event);
  79     void OnHelp(wxCommandEvent& event);
  80
  81     void OnWizEvent(wxWizardEvent& event);
  82
  83     void AddBitmapRow(wxBoxSizer *mainColumn);
  84     void AddStaticLine(wxBoxSizer *mainColumn);
  85     void AddBackNextPair(wxBoxSizer *buttonRow);
  86     void AddButtonRow(wxBoxSizer *mainColumn);
  87
  88     wxSize GetManualPageSize() const;
  89
  90     // the page size requested by user
  91     wxSize m_sizePage;
  92
  93     // the dialog position from the ctor
  94     wxPoint m_posWizard;
  95
  96     // wizard state
  97     wxWizardPage *m_page;       // the current page or NULL
  98     wxBitmap      m_bitmap;     // the default bitmap to show
  99
 100     // wizard controls
 101     wxButton    *m_btnPrev,     // the "<Back" button
 102                 *m_btnNext;     // the "Next>" or "Finish" button
 103     wxStaticBitmap *m_statbmp;  // the control for the bitmap
 104
 105     // Whether user called SetBorder()
 106     bool m_calledSetBorder;
 107     // Border around page area sizer requested using SetBorder()
 108     int m_border;
 109
 110     // Whether RunWizard() was called
 111     bool m_started;
 112
 113     // Page area sizer will be inserted here with padding
 114     wxBoxSizer *m_sizerBmpAndPage;
 115
 116     // Actual position and size of pages
 117     wxWizardSizer *m_sizerPage;
 118
 119     friend class wxWizardSizer;
 120
 121     DECLARE_DYNAMIC_CLASS(wxWizard)
 122     DECLARE_EVENT_TABLE()
 123     DECLARE_NO_COPY_CLASS(wxWizard)
 124 };
 125