X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/66cd017c29f69d178d09f6c6a05040461a325709..79f585d90388128f9d245f7c92d3013b98b9ed14:/src/generic/wizard.cpp?ds=inline diff --git a/src/generic/wizard.cpp b/src/generic/wizard.cpp index 6fec89ad79..fdd9dc7a8c 100644 --- a/src/generic/wizard.cpp +++ b/src/generic/wizard.cpp @@ -31,6 +31,7 @@ #ifndef WX_PRECOMP #include "wx/dynarray.h" #include "wx/intl.h" + #include "wx/statbmp.h" #endif //WX_PRECOMP #include "wx/statline.h" @@ -43,95 +44,59 @@ WX_DEFINE_ARRAY(wxPanel *, wxArrayPages); -// ---------------------------------------------------------------------------- -// wxWizardGeneric - generic implementation of wxWizard -// ---------------------------------------------------------------------------- - -class wxWizardGeneric : public wxWizard -{ -public: - // ctor - wxWizardGeneric(wxWindow *parent, - int id, - const wxString& title, - const wxBitmap& bitmap, - const wxPoint& pos, - const wxSize& size); - - // implement base class pure virtuals - virtual void AddPage(wxPanel *page); - virtual void InsertPage(int nPage, wxPanel *page); - virtual bool RunWizard(); - virtual wxPanel *GetCurrentPage() const; - - // implementation only from now on - // ------------------------------- - - // is the wizard running? - bool IsRunning() const { return m_page != -1; } - - // show the given page calling TransferDataFromWindow - if it returns - // FALSE, the old page is not hidden and the function returns FALSE - bool ShowPage(size_t page); - - // get the current page assuming the wizard is running - wxPanel *DoGetCurrentPage() const - { - wxASSERT_MSG( IsRunning(), _T("no current page!") ); - - return m_pages[(size_t)m_page]; - } - - // place the given page correctly and hide it - void DoAddPage(wxPanel *page); - -private: - // event handlers - void OnCancel(wxCommandEvent& event); - void OnBackOrNext(wxCommandEvent& event); - - // wizard dimensions - int m_x, m_y; // the origin for the pages - int m_width, // the size of the page itself - m_height; // (total width is m_width + m_x) - - // wizard state - int m_page; // the current page or -1 - wxArrayPages m_pages; // the array with all wizards pages - - // wizard controls - wxButton *m_btnPrev, // the "" or "Finish" button - - DECLARE_EVENT_TABLE() -}; - // ---------------------------------------------------------------------------- // event tables and such // ---------------------------------------------------------------------------- -BEGIN_EVENT_TABLE(wxWizardGeneric, wxDialog) - EVT_BUTTON(wxID_CANCEL, OnCancel) - EVT_BUTTON(-1, OnBackOrNext) +BEGIN_EVENT_TABLE(wxWizard, wxDialog) + EVT_BUTTON(wxID_CANCEL, wxWizard::OnCancel) + EVT_BUTTON(-1, wxWizard::OnBackOrNext) END_EVENT_TABLE() -IMPLEMENT_ABSTRACT_CLASS(wxWizard, wxDialog) +IMPLEMENT_DYNAMIC_CLASS(wxWizard, wxDialog) +IMPLEMENT_ABSTRACT_CLASS(wxWizardPage, wxPanel) +IMPLEMENT_DYNAMIC_CLASS(wxWizardPageSimple, wxWizardPage) IMPLEMENT_DYNAMIC_CLASS(wxWizardEvent, wxNotifyEvent) // ============================================================================ // implementation // ============================================================================ +// ---------------------------------------------------------------------------- +// wxWizardPage +// ---------------------------------------------------------------------------- + +wxWizardPage::wxWizardPage(wxWizard *parent, const wxBitmap& bitmap) + : wxPanel(parent), m_bitmap(bitmap) +{ + // initially the page is hidden, it's shown only when it becomes current + Hide(); +} + +// ---------------------------------------------------------------------------- +// wxWizardPageSimple +// ---------------------------------------------------------------------------- + +wxWizardPage *wxWizardPageSimple::GetPrev() const +{ + return m_prev; +} + +wxWizardPage *wxWizardPageSimple::GetNext() const +{ + return m_next; +} // ---------------------------------------------------------------------------- // generic wxWizard implementation // ---------------------------------------------------------------------------- -wxWizardGeneric::wxWizardGeneric(wxWindow *parent, - int id, - const wxString& title, - const wxBitmap& bitmap, - const wxPoint& pos, - const wxSize& size) +wxWizard::wxWizard(wxWindow *parent, + int id, + const wxString& title, + const wxBitmap& bitmap, + const wxPoint& pos, + const wxSize& size) + : m_bitmap(bitmap) { // constants defining the dialog layout // ------------------------------------ @@ -160,7 +125,7 @@ wxWizardGeneric::wxWizardGeneric(wxWindow *parent, // init members // ------------ - m_page = -1; + m_page = (wxWizardPage *)NULL; // create controls // --------------- @@ -176,13 +141,15 @@ wxWizardGeneric::wxWizardGeneric(wxWindow *parent, m_y = Y_MARGIN; if ( bitmap.Ok() ) { - (void)new wxStaticBitmap(this, -1, bitmap, wxPoint(m_x, m_y)); + m_statbmp = new wxStaticBitmap(this, -1, bitmap, wxPoint(m_x, m_y)); m_x += bitmap.GetWidth() + BITMAP_X_MARGIN; m_height = bitmap.GetHeight(); } else { + m_statbmp = (wxStaticBitmap *)NULL; + m_height = DEFAULT_PAGE_HEIGHT; } @@ -190,8 +157,11 @@ wxWizardGeneric::wxWizardGeneric(wxWindow *parent, int x = X_MARGIN; int y = m_y + m_height + BITMAP_Y_MARGIN; + +#if wxUSE_STATLINE (void)new wxStaticLine(this, -1, wxPoint(x, y), wxSize(m_x + m_width - x, 2)); +#endif x = m_x + m_width - 3*sizeBtn.x - BUTTON_MARGIN; y += SEPARATOR_LINE_MARGIN; @@ -215,87 +185,123 @@ wxWizardGeneric::wxWizardGeneric(wxWindow *parent, if ( pos == wxDefaultPosition ) { - Centre(); + CentreOnScreen(); } } -bool wxWizardGeneric::ShowPage(size_t page) +bool wxWizard::ShowPage(wxWizardPage *page, bool goingForward) { - wxCHECK_MSG( page < m_pages.GetCount(), FALSE, - _T("invalid wizard page index") ); + wxASSERT_MSG( page != m_page, wxT("this is useless") ); - wxASSERT_MSG( page != (size_t)m_page, _T("this is useless") ); + // we'll use this to decide whether we have to change the label of this + // button or not (initially the label is "Next") + bool btnLabelWasNext = TRUE; - size_t last = m_pages.GetCount() - 1; - bool mustChangeNextBtnLabel = (size_t)m_page == last || page == last; + // and this tells us whether we already had the default bitmap before + bool bmpWasDefault = TRUE; - if ( m_page != -1 ) + if ( m_page ) { - wxPanel *panel = DoGetCurrentPage(); - if ( !panel->TransferDataFromWindow() ) + // ask the current page first + if ( !m_page->TransferDataFromWindow() ) + { + // the page data is incorrect + return FALSE; + } + + // send the event to the old page + wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGING, GetId(), goingForward); + if ( m_page->GetEventHandler()->ProcessEvent(event) && + !event.IsAllowed() ) + { + // vetoed by the page return FALSE; + } + + m_page->Hide(); - panel->Hide(); + btnLabelWasNext = m_page->GetNext() != (wxWizardPage *)NULL; + bmpWasDefault = !m_page->GetBitmap().Ok(); } + // set the new one m_page = page; - DoGetCurrentPage()->Show(); - // update the buttons state - m_btnPrev->Enable(m_page != 0); - if ( mustChangeNextBtnLabel ) + // is this the end? + if ( !m_page ) { - m_btnNext->SetLabel((size_t)m_page == last ? _("&Finish") - : _("&Next >")); + // terminate successfully + EndModal(wxID_OK); + + return TRUE; } - return TRUE; -} + // send the event to the new page now + wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGED, GetId(), goingForward); + (void)m_page->GetEventHandler()->ProcessEvent(event); -void wxWizardGeneric::DoAddPage(wxPanel *page) -{ - page->Hide(); - page->SetSize(m_x, m_y, m_width, m_height); -} + // position and show the new page + (void)m_page->TransferDataToWindow(); + m_page->SetSize(m_x, m_y, m_width, m_height); + m_page->Show(); -void wxWizardGeneric::AddPage(wxPanel *page) -{ - m_pages.Add(page); + // change the bitmap if necessary (and if we have it at all) + bool bmpIsDefault = !m_page->GetBitmap().Ok(); + if ( m_statbmp && (bmpIsDefault != bmpWasDefault) ) + { + wxBitmap bmp; + if ( bmpIsDefault ) + bmp = m_bitmap; + else + bmp = m_page->GetBitmap(); + m_statbmp->SetBitmap(bmp); + } - DoAddPage(page); -} + // and update the buttons state + m_btnPrev->Enable(m_page->GetPrev() != (wxWizardPage *)NULL); -void wxWizardGeneric::InsertPage(int nPage, wxPanel *page) -{ - m_pages.Insert(page, nPage); - if ( nPage < m_page ) + bool hasNext = m_page->GetNext() != (wxWizardPage *)NULL; + if ( btnLabelWasNext != hasNext ) { - // the indices of all pages after the inserted one are shifted by 1 - m_page++; + // need to update + if (btnLabelWasNext) + m_btnNext->SetLabel(_("&Finish")); + else + m_btnNext->SetLabel(_("&Next >")); } + // nothing to do: the label was already correct - DoAddPage(page); + return TRUE; } -bool wxWizardGeneric::RunWizard() +bool wxWizard::RunWizard(wxWizardPage *firstPage) { - wxCHECK_MSG( m_pages.GetCount() != 0, FALSE, _T("can't run empty wizard") ); + wxCHECK_MSG( firstPage, FALSE, wxT("can't run empty wizard") ); // can't return FALSE here because there is no old page - (void)ShowPage(0u); + (void)ShowPage(firstPage, TRUE /* forward */); return ShowModal() == wxID_OK; } -wxPanel *wxWizardGeneric::GetCurrentPage() const +wxWizardPage *wxWizard::GetCurrentPage() const { - return IsRunning() ? DoGetCurrentPage() : (wxPanel *)NULL; + return m_page; } -void wxWizardGeneric::OnCancel(wxCommandEvent& WXUNUSED(event)) +wxSize wxWizard::GetPageSize() const { + return wxSize(m_width, m_height); +} + +void wxWizard::OnCancel(wxCommandEvent& WXUNUSED(event)) +{ + // this function probably can never be called when we don't have an active + // page, but a small extra check won't hurt + wxWindow *win = m_page ? (wxWindow *)m_page : (wxWindow *)this; + wxWizardEvent event(wxEVT_WIZARD_CANCEL, GetId()); - if ( !GetEventHandler()->ProcessEvent(event) || event.IsAllowed() ) + if ( !win->GetEventHandler()->ProcessEvent(event) || event.IsAllowed() ) { // no objections - close the dialog EndModal(wxID_CANCEL); @@ -303,53 +309,52 @@ void wxWizardGeneric::OnCancel(wxCommandEvent& WXUNUSED(event)) //else: request to Cancel ignored } -void wxWizardGeneric::OnBackOrNext(wxCommandEvent& event) +void wxWizard::OnBackOrNext(wxCommandEvent& event) { wxASSERT_MSG( (event.GetEventObject() == m_btnNext) || (event.GetEventObject() == m_btnPrev), - _T("unknown button") ); + wxT("unknown button") ); - int delta = event.GetEventObject() == m_btnNext ? 1 : -1; - int page = m_page + delta; + bool forward = event.GetEventObject() == m_btnNext; - wxASSERT_MSG( page >= 0, _T("'Back' button should have been disabled!") ); - - if ( (size_t)page == m_pages.GetCount() ) + wxWizardPage *page; + if ( forward ) { - // check that we have valid data in the last page too - if ( m_pages.Last()->TransferDataFromWindow() ) - { - // that's all, folks! - EndModal(wxID_OK); - } + page = m_page->GetNext(); } - else + else // back { - // just pass to the next page (or may be not - but we don't care here) - (void)ShowPage(page); + page = m_page->GetPrev(); + + wxASSERT_MSG( page, wxT("\"