src/generic/wizard.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        generic/wizard.cpp
   3 // Purpose:     generic implementation of wxWizard class
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     15.08.99
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows license
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation ".h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/dynarray.h"
  33     #include "wx/intl.h"
  34     #include "wx/statbmp.h"
  35 #endif //WX_PRECOMP
  36
  37 #include "wx/statline.h"
  38
  39 #include "wx/wizard.h"
  40
  41 // ----------------------------------------------------------------------------
  42 // simple types
  43 // ----------------------------------------------------------------------------
  44
  45 WX_DEFINE_ARRAY(wxPanel *, wxArrayPages);
  46
  47 // ----------------------------------------------------------------------------
  48 // event tables and such
  49 // ----------------------------------------------------------------------------
  50
  51 BEGIN_EVENT_TABLE(wxWizard, wxDialog)
  52     EVT_BUTTON(wxID_CANCEL, wxWizard::OnCancel)
  53     EVT_BUTTON(-1, wxWizard::OnBackOrNext)
  54 END_EVENT_TABLE()
  55
  56 IMPLEMENT_DYNAMIC_CLASS(wxWizard, wxDialog)
  57 IMPLEMENT_ABSTRACT_CLASS(wxWizardPage, wxPanel)
  58 IMPLEMENT_DYNAMIC_CLASS(wxWizardPageSimple, wxWizardPage)
  59 IMPLEMENT_DYNAMIC_CLASS(wxWizardEvent, wxNotifyEvent)
  60
  61 // ============================================================================
  62 // implementation
  63 // ============================================================================
  64
  65 // ----------------------------------------------------------------------------
  66 // wxWizardPage
  67 // ----------------------------------------------------------------------------
  68
  69 wxWizardPage::wxWizardPage(wxWizard *parent) : wxPanel(parent)
  70 {
  71     // initially the page is hidden, it's shown only when it becomes current
  72     Hide();
  73 }
  74
  75 // ----------------------------------------------------------------------------
  76 // wxWizardPageSimple
  77 // ----------------------------------------------------------------------------
  78
  79 wxWizardPage *wxWizardPageSimple::GetPrev() const
  80 {
  81     return m_prev;
  82 }
  83
  84 wxWizardPage *wxWizardPageSimple::GetNext() const
  85 {
  86     return m_next;
  87 }
  88 // ----------------------------------------------------------------------------
  89 // generic wxWizard implementation
  90 // ----------------------------------------------------------------------------
  91
  92 wxWizard::wxWizard(wxWindow *parent,
  93                    int id,
  94                    const wxString& title,
  95                    const wxBitmap& bitmap,
  96                    const wxPoint& pos,
  97                    const wxSize& size)
  98 {
  99     // constants defining the dialog layout
 100     // ------------------------------------
 101
 102     // these constants define the position of the upper left corner of the
 103     // bitmap or the page in the wizard
 104     static const int X_MARGIN = 10;
 105     static const int Y_MARGIN = 10;
 106
 107     // margin between the bitmap and the panel
 108     static const int BITMAP_X_MARGIN = 15;
 109
 110     // margin between the bitmap and the static line
 111     static const int BITMAP_Y_MARGIN = 15;
 112
 113     // margin between the static line and the buttons
 114     static const int SEPARATOR_LINE_MARGIN = 15;
 115
 116     // margin between "Next >" and "Cancel" buttons
 117     static const int BUTTON_MARGIN = 10;
 118
 119     // default width and height of the page
 120     static const int DEFAULT_PAGE_WIDTH = 270;
 121     static const int DEFAULT_PAGE_HEIGHT = 290;
 122
 123     // init members
 124     // ------------
 125
 126     m_page = (wxWizardPage *)NULL;
 127
 128     // create controls
 129     // ---------------
 130
 131     wxSize sizeBtn = wxButton::GetDefaultSize();
 132
 133     (void)wxDialog::Create(parent, id, title, pos, size);
 134
 135     // the global dialog layout is: a row of buttons at the bottom (aligned to
 136     // the right), the static line above them, the bitmap (if any) on the left
 137     // of the upper part of the dialog and the panel in the remaining space
 138     m_x = X_MARGIN;
 139     m_y = Y_MARGIN;
 140     if ( bitmap.Ok() )
 141     {
 142         (void)new wxStaticBitmap(this, -1, bitmap, wxPoint(m_x, m_y));
 143
 144         m_x += bitmap.GetWidth() + BITMAP_X_MARGIN;
 145         m_height = bitmap.GetHeight();
 146     }
 147     else
 148     {
 149         m_height = DEFAULT_PAGE_HEIGHT;
 150     }
 151
 152     m_width = DEFAULT_PAGE_WIDTH;
 153
 154     int x = X_MARGIN;
 155     int y = m_y + m_height + BITMAP_Y_MARGIN;
 156
 157 #if wxUSE_STATLINE
 158     (void)new wxStaticLine(this, -1, wxPoint(x, y),
 159                            wxSize(m_x + m_width - x, 2));
 160 #endif
 161
 162     x = m_x + m_width - 3*sizeBtn.x - BUTTON_MARGIN;
 163     y += SEPARATOR_LINE_MARGIN;
 164     m_btnPrev = new wxButton(this, -1, _("< &Back"), wxPoint(x, y), sizeBtn);
 165
 166     x += sizeBtn.x;
 167     m_btnNext = new wxButton(this, -1, _("&Next >"), wxPoint(x, y), sizeBtn);
 168
 169     x += sizeBtn.x + BUTTON_MARGIN;
 170     (void)new wxButton(this, wxID_CANCEL, _("Cancel"), wxPoint(x, y), sizeBtn);
 171
 172     // position and size the dialog
 173     // ----------------------------
 174
 175     if ( size == wxDefaultSize )
 176     {
 177         SetClientSize(m_x + m_width + X_MARGIN,
 178                       m_y + m_height + BITMAP_Y_MARGIN +
 179                         SEPARATOR_LINE_MARGIN + sizeBtn.y + Y_MARGIN);
 180     }
 181
 182     if ( pos == wxDefaultPosition )
 183     {
 184         Centre();
 185     }
 186 }
 187
 188 bool wxWizard::ShowPage(wxWizardPage *page, bool goingForward)
 189 {
 190     wxASSERT_MSG( page != m_page, _T("this is useless") );
 191
 192     // we'll use this to decide whether we have to change the label of this
 193     // button or not (initially the label is "Next")
 194     bool btnLabelWasNext = TRUE;
 195
 196     if ( m_page )
 197     {
 198         // ask the current page first
 199         if ( !m_page->TransferDataFromWindow() )
 200         {
 201             // the page data is incorrect
 202             return FALSE;
 203         }
 204
 205         // send the event to the old page
 206         wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGING, GetId(), goingForward);
 207         if ( m_page->GetEventHandler()->ProcessEvent(event) &&
 208              !event.IsAllowed() )
 209         {
 210             // vetoed by the page
 211             return FALSE;
 212         }
 213
 214         m_page->Hide();
 215
 216         btnLabelWasNext = m_page->GetNext() != (wxWizardPage *)NULL;
 217     }
 218
 219     // set the new one
 220     m_page = page;
 221
 222     // is this the end?
 223     if ( !m_page )
 224     {
 225         // terminate successfully
 226         EndModal(wxID_OK);
 227
 228         return TRUE;
 229     }
 230
 231     // send the event to the new page now
 232     wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGED, GetId(), goingForward);
 233     (void)m_page->GetEventHandler()->ProcessEvent(event);
 234
 235     // position and show the new page
 236     (void)m_page->TransferDataToWindow();
 237     m_page->SetSize(m_x, m_y, m_width, m_height);
 238     m_page->Show();
 239
 240     // and update the buttons state
 241     m_btnPrev->Enable(m_page->GetPrev() != (wxWizardPage *)NULL);
 242
 243     if ( btnLabelWasNext != (m_page->GetNext() != (wxWizardPage *)NULL) )
 244     {
 245         // need to update
 246         m_btnNext->SetLabel(btnLabelWasNext ? _("&Finish") : _("&Next >"));
 247     }
 248     // nothing to do: the label was already correct
 249
 250     return TRUE;
 251 }
 252
 253 bool wxWizard::RunWizard(wxWizardPage *firstPage)
 254 {
 255     wxCHECK_MSG( firstPage, FALSE, _T("can't run empty wizard") );
 256
 257     // can't return FALSE here because there is no old page
 258     (void)ShowPage(firstPage, TRUE /* forward */);
 259
 260     return ShowModal() == wxID_OK;
 261 }
 262
 263 wxWizardPage *wxWizard::GetCurrentPage() const
 264 {
 265     return m_page;
 266 }
 267
 268 void wxWizard::OnCancel(wxCommandEvent& WXUNUSED(event))
 269 {
 270     // this function probably can never be called when we don't have an active
 271     // page, but a small extra check won't hurt
 272     wxWindow *win = m_page ? (wxWindow *)m_page : (wxWindow *)this;
 273
 274     wxWizardEvent event(wxEVT_WIZARD_CANCEL, GetId());
 275     if ( !win->GetEventHandler()->ProcessEvent(event) || event.IsAllowed() )
 276     {
 277         // no objections - close the dialog
 278         EndModal(wxID_CANCEL);
 279     }
 280     //else: request to Cancel ignored
 281 }
 282
 283 void wxWizard::OnBackOrNext(wxCommandEvent& event)
 284 {
 285     wxASSERT_MSG( (event.GetEventObject() == m_btnNext) ||
 286                   (event.GetEventObject() == m_btnPrev),
 287                   _T("unknown button") );
 288
 289     bool forward = event.GetEventObject() == m_btnNext;
 290
 291     wxWizardPage *page;
 292     if ( forward )
 293     {
 294         page = m_page->GetNext();
 295     }
 296     else // back
 297     {
 298         page = m_page->GetPrev();
 299
 300         wxASSERT_MSG( page, _T("\"<Back\" button should have been disabled") );
 301     }
 302
 303     // just pass to the new page (or may be not - but we don't care here)
 304     (void)ShowPage(page, forward);
 305 }
 306
 307 // ----------------------------------------------------------------------------
 308 // our public interface
 309 // ----------------------------------------------------------------------------
 310
 311 /* static */
 312 wxWizard *wxWizardBase::Create(wxWindow *parent,
 313                                int id,
 314                                const wxString& title,
 315                                const wxBitmap& bitmap,
 316                                const wxPoint& pos,
 317                                const wxSize& size)
 318 {
 319     return new wxWizard(parent, id, title, bitmap, pos, size);
 320 }
 321
 322 // ----------------------------------------------------------------------------
 323 // wxWizardEvent
 324 // ----------------------------------------------------------------------------
 325
 326 wxWizardEvent::wxWizardEvent(wxEventType type, int id, bool direction)
 327              : wxNotifyEvent(type, id)
 328 {
 329     m_direction = direction;
 330 }
 331