include/wx/generic/wizard.h

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