renamed wizard sample
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@6708 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
		
							
								
								
									
										355
									
								
								samples/wizard/wizard.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										355
									
								
								samples/wizard/wizard.cpp
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,355 @@
 | 
			
		||||
/////////////////////////////////////////////////////////////////////////////
 | 
			
		||||
// Name:        wizard.cpp
 | 
			
		||||
// Purpose:     wxWindows sample demonstrating wxWizard control
 | 
			
		||||
// Author:      Vadim Zeitlin
 | 
			
		||||
// Modified by:
 | 
			
		||||
// Created:     15.08.99
 | 
			
		||||
// RCS-ID:      $Id$
 | 
			
		||||
// Copyright:   (c) Vadim Zeitlin
 | 
			
		||||
// Licence:     wxWindows licence
 | 
			
		||||
/////////////////////////////////////////////////////////////////////////////
 | 
			
		||||
 | 
			
		||||
// ============================================================================
 | 
			
		||||
// declarations
 | 
			
		||||
// ============================================================================
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// headers
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
#ifdef __GNUG__
 | 
			
		||||
    #pragma implementation "wizard.cpp"
 | 
			
		||||
    #pragma interface "wizard.cpp"
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
// For compilers that support precompilation, includes "wx/wx.h".
 | 
			
		||||
#include "wx/wxprec.h"
 | 
			
		||||
 | 
			
		||||
#ifdef __BORLANDC__
 | 
			
		||||
    #pragma hdrstop
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
// for all others, include the necessary headers (this file is usually all you
 | 
			
		||||
// need because it includes almost all "standard" wxWindows headers
 | 
			
		||||
#ifndef WX_PRECOMP
 | 
			
		||||
    #include "wx/wx.h"
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
#include "wx/wizard.h"
 | 
			
		||||
 | 
			
		||||
#ifndef __WXMSW__
 | 
			
		||||
    #include "wiztest.xpm"
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// constants
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
// ids for menu items
 | 
			
		||||
enum
 | 
			
		||||
{
 | 
			
		||||
    Wizard_Quit = 100,
 | 
			
		||||
    Wizard_Run,
 | 
			
		||||
    Wizard_About = 1000
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// ressources
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
#ifdef __WXMSW__
 | 
			
		||||
    #define BMP_WIZARD_1 wxBitmap("wiztest.bmp", wxBITMAP_TYPE_BMP)
 | 
			
		||||
    #define BMP_WIZARD_2 wxBitmap("wiztest2.bmp", wxBITMAP_TYPE_BMP)
 | 
			
		||||
#else
 | 
			
		||||
    #define BMP_WIZARD_1 wxBitmap(wizimage)
 | 
			
		||||
    #define BMP_WIZARD_2 wxBitmap(wizimage)
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// private classes
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
// Define a new application type, each program should derive a class from wxApp
 | 
			
		||||
class MyApp : public wxApp
 | 
			
		||||
{
 | 
			
		||||
public:
 | 
			
		||||
    // override base class virtuals
 | 
			
		||||
    virtual bool OnInit();
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
class MyFrame : public wxFrame
 | 
			
		||||
{
 | 
			
		||||
public:
 | 
			
		||||
    // ctor(s)
 | 
			
		||||
    MyFrame(const wxString& title);
 | 
			
		||||
 | 
			
		||||
    // event handlers (these functions should _not_ be virtual)
 | 
			
		||||
    void OnQuit(wxCommandEvent& event);
 | 
			
		||||
    void OnAbout(wxCommandEvent& event);
 | 
			
		||||
    void OnRunWizard(wxCommandEvent& event);
 | 
			
		||||
    void OnWizardCancel(wxWizardEvent& event);
 | 
			
		||||
 | 
			
		||||
private:
 | 
			
		||||
    // any class wishing to process wxWindows events must use this macro
 | 
			
		||||
    DECLARE_EVENT_TABLE()
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// some pages for our wizard
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
// this shows how to simply control the validity of the user input by just
 | 
			
		||||
// overriding TransferDataFromWindow() - of course, in a real program, the
 | 
			
		||||
// check wouldn't be so trivial and the data will be probably saved somewhere
 | 
			
		||||
// too
 | 
			
		||||
//
 | 
			
		||||
// it also shows how to use a different bitmap for one of the pages
 | 
			
		||||
class wxValidationPage : public wxWizardPageSimple
 | 
			
		||||
{
 | 
			
		||||
public:
 | 
			
		||||
    wxValidationPage(wxWizard *parent) : wxWizardPageSimple(parent)
 | 
			
		||||
    {
 | 
			
		||||
        m_bitmap = BMP_WIZARD_2;
 | 
			
		||||
 | 
			
		||||
        m_checkbox = new wxCheckBox(this, -1, "&Check me");
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    virtual bool TransferDataFromWindow()
 | 
			
		||||
    {
 | 
			
		||||
        if ( !m_checkbox->GetValue() )
 | 
			
		||||
        {
 | 
			
		||||
            wxMessageBox("Check the checkbox first!", "No way",
 | 
			
		||||
                         wxICON_WARNING | wxOK, this);
 | 
			
		||||
 | 
			
		||||
            return FALSE;
 | 
			
		||||
        }
 | 
			
		||||
 | 
			
		||||
        return TRUE;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
private:
 | 
			
		||||
    wxCheckBox *m_checkbox;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// This is a more complicated example of validity checking: using events we may
 | 
			
		||||
// allow to return to the previous page, but not to proceed. It also
 | 
			
		||||
// demonstrates how to intercept [Cancel] button press.
 | 
			
		||||
class wxRadioboxPage : public wxWizardPageSimple
 | 
			
		||||
{
 | 
			
		||||
public:
 | 
			
		||||
    // directions in which we allow the user to proceed from this page
 | 
			
		||||
    enum
 | 
			
		||||
    {
 | 
			
		||||
        Forward, Backward, Both, Neither
 | 
			
		||||
    };
 | 
			
		||||
 | 
			
		||||
    wxRadioboxPage(wxWizard *parent) : wxWizardPageSimple(parent)
 | 
			
		||||
    {
 | 
			
		||||
        // should correspond to the enum above
 | 
			
		||||
        //        static wxString choices[] = { "forward", "backward", "both", "neither" };
 | 
			
		||||
        // The above syntax can cause an internal compiler error with gcc.
 | 
			
		||||
        wxString choices[4];
 | 
			
		||||
        choices[0] = "forward";
 | 
			
		||||
        choices[1] = "backward";
 | 
			
		||||
        choices[2] = "both";
 | 
			
		||||
        choices[3] = "neither";
 | 
			
		||||
 | 
			
		||||
        m_radio = new wxRadioBox(this, -1, "Allow to proceed:",
 | 
			
		||||
                                 wxPoint(5, 5), wxDefaultSize,
 | 
			
		||||
                                 WXSIZEOF(choices), choices,
 | 
			
		||||
                                 1, wxRA_SPECIFY_COLS);
 | 
			
		||||
        m_radio->SetSelection(Both);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    // wizard event handlers
 | 
			
		||||
    void OnWizardCancel(wxWizardEvent& event)
 | 
			
		||||
    {
 | 
			
		||||
        if ( wxMessageBox("Do you really want to cancel?", "Question",
 | 
			
		||||
                          wxICON_QUESTION | wxYES_NO, this) != wxYES )
 | 
			
		||||
        {
 | 
			
		||||
            // not confirmed
 | 
			
		||||
            event.Veto();
 | 
			
		||||
        }
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    void OnWizardPageChanging(wxWizardEvent& event)
 | 
			
		||||
    {
 | 
			
		||||
        int sel = m_radio->GetSelection();
 | 
			
		||||
 | 
			
		||||
        if ( sel == Both )
 | 
			
		||||
            return;
 | 
			
		||||
 | 
			
		||||
        if ( event.GetDirection() && sel == Forward )
 | 
			
		||||
            return;
 | 
			
		||||
 | 
			
		||||
        if ( !event.GetDirection() && sel == Backward )
 | 
			
		||||
            return;
 | 
			
		||||
 | 
			
		||||
        wxMessageBox("You can't go there", "Not allowed",
 | 
			
		||||
                     wxICON_WARNING | wxOK, this);
 | 
			
		||||
 | 
			
		||||
        event.Veto();
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
private:
 | 
			
		||||
    wxRadioBox *m_radio;
 | 
			
		||||
 | 
			
		||||
    DECLARE_EVENT_TABLE()
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// this shows how to dynamically (i.e. during run-time) arrange the page order
 | 
			
		||||
class wxCheckboxPage : public wxWizardPage
 | 
			
		||||
{
 | 
			
		||||
public:
 | 
			
		||||
    wxCheckboxPage(wxWizard *parent,
 | 
			
		||||
                   wxWizardPage *prev,
 | 
			
		||||
                   wxWizardPage *next)
 | 
			
		||||
        : wxWizardPage(parent)
 | 
			
		||||
    {
 | 
			
		||||
        m_prev = prev;
 | 
			
		||||
        m_next = next;
 | 
			
		||||
 | 
			
		||||
        (void)new wxStaticText(this, -1, "Try checking the box below and\n"
 | 
			
		||||
                                         "then going back and clearing it");
 | 
			
		||||
 | 
			
		||||
        m_checkbox = new wxCheckBox(this, -1, "&Skip the next page",
 | 
			
		||||
                                    wxPoint(5, 30));
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    // implement wxWizardPage functions
 | 
			
		||||
    virtual wxWizardPage *GetPrev() const { return m_prev; }
 | 
			
		||||
    virtual wxWizardPage *GetNext() const
 | 
			
		||||
    {
 | 
			
		||||
        return m_checkbox->GetValue() ? m_next->GetNext() : m_next;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
private:
 | 
			
		||||
    wxWizardPage *m_prev,
 | 
			
		||||
                 *m_next;
 | 
			
		||||
 | 
			
		||||
    wxCheckBox *m_checkbox;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// ============================================================================
 | 
			
		||||
// implementation
 | 
			
		||||
// ============================================================================
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// event tables and such
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
BEGIN_EVENT_TABLE(MyFrame, wxFrame)
 | 
			
		||||
    EVT_MENU(Wizard_Quit,  MyFrame::OnQuit)
 | 
			
		||||
    EVT_MENU(Wizard_About, MyFrame::OnAbout)
 | 
			
		||||
    EVT_MENU(Wizard_Run,   MyFrame::OnRunWizard)
 | 
			
		||||
 | 
			
		||||
    EVT_WIZARD_CANCEL(-1, MyFrame::OnWizardCancel)
 | 
			
		||||
END_EVENT_TABLE()
 | 
			
		||||
 | 
			
		||||
BEGIN_EVENT_TABLE(wxRadioboxPage, wxWizardPageSimple)
 | 
			
		||||
    EVT_WIZARD_PAGE_CHANGING(-1, wxRadioboxPage::OnWizardPageChanging)
 | 
			
		||||
    EVT_WIZARD_CANCEL(-1, wxRadioboxPage::OnWizardCancel)
 | 
			
		||||
END_EVENT_TABLE()
 | 
			
		||||
 | 
			
		||||
IMPLEMENT_APP(MyApp)
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// the application class
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
// `Main program' equivalent: the program execution "starts" here
 | 
			
		||||
bool MyApp::OnInit()
 | 
			
		||||
{
 | 
			
		||||
    MyFrame *frame = new MyFrame("wxWizard Sample");
 | 
			
		||||
 | 
			
		||||
    // and show it (the frames, unlike simple controls, are not shown when
 | 
			
		||||
    // created initially)
 | 
			
		||||
    frame->Show(TRUE);
 | 
			
		||||
 | 
			
		||||
    // we're done
 | 
			
		||||
    return TRUE;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
// MyFrame
 | 
			
		||||
// ----------------------------------------------------------------------------
 | 
			
		||||
 | 
			
		||||
MyFrame::MyFrame(const wxString& title)
 | 
			
		||||
       : wxFrame((wxFrame *)NULL, -1, title,
 | 
			
		||||
                  wxDefaultPosition, wxSize(250, 150))  // small frame
 | 
			
		||||
{
 | 
			
		||||
    wxMenu *menuFile = new wxMenu;
 | 
			
		||||
    menuFile->Append(Wizard_Run, "&Run wizard...\tCtrl-R");
 | 
			
		||||
    menuFile->AppendSeparator();
 | 
			
		||||
    menuFile->Append(Wizard_Quit, "E&xit\tAlt-X", "Quit this program");
 | 
			
		||||
 | 
			
		||||
    wxMenu *helpMenu = new wxMenu;
 | 
			
		||||
    helpMenu->Append(Wizard_About, "&About...\tF1", "Show about dialog");
 | 
			
		||||
 | 
			
		||||
    // now append the freshly created menu to the menu bar...
 | 
			
		||||
    wxMenuBar *menuBar = new wxMenuBar();
 | 
			
		||||
    menuBar->Append(menuFile, "&File");
 | 
			
		||||
    menuBar->Append(helpMenu, "&Help");
 | 
			
		||||
 | 
			
		||||
    // ... and attach this menu bar to the frame
 | 
			
		||||
    SetMenuBar(menuBar);
 | 
			
		||||
 | 
			
		||||
    // also create status bar which we use in OnWizardCancel
 | 
			
		||||
    CreateStatusBar();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
 | 
			
		||||
{
 | 
			
		||||
    // TRUE is to force the frame to close
 | 
			
		||||
    Close(TRUE);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 | 
			
		||||
{
 | 
			
		||||
    wxMessageBox("Demo of wxWizard class\n"
 | 
			
		||||
                 "<EFBFBD> 1999, 2000 Vadim Zeitlin",
 | 
			
		||||
                 "About wxWizard sample", wxOK | wxICON_INFORMATION, this);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
void MyFrame::OnRunWizard(wxCommandEvent& WXUNUSED(event))
 | 
			
		||||
{
 | 
			
		||||
    wxWizard *wizard = wxWizard::Create(this, -1,
 | 
			
		||||
                                        "Absolutely Useless Wizard",
 | 
			
		||||
                                        BMP_WIZARD_1);
 | 
			
		||||
 | 
			
		||||
    // a wizard page may be either an object of predefined class
 | 
			
		||||
    wxWizardPageSimple *page1 = new wxWizardPageSimple(wizard);
 | 
			
		||||
    (void)new wxStaticText(page1, -1,
 | 
			
		||||
                           "This wizard doesn't help you to do anything at "
 | 
			
		||||
                           "all.\n"
 | 
			
		||||
                           "\n"
 | 
			
		||||
                           "The next pages will present you with more useless "
 | 
			
		||||
                           "controls.");
 | 
			
		||||
 | 
			
		||||
    // ... or a derived class
 | 
			
		||||
    wxRadioboxPage *page3 = new wxRadioboxPage(wizard);
 | 
			
		||||
    wxValidationPage *page4 = new wxValidationPage(wizard);
 | 
			
		||||
 | 
			
		||||
    // set the page order using a convenience function - could also use
 | 
			
		||||
    // SetNext/Prev directly as below
 | 
			
		||||
    wxWizardPageSimple::Chain(page3, page4);
 | 
			
		||||
 | 
			
		||||
    // this page is not a wxWizardPageSimple, so we use SetNext/Prev to insert
 | 
			
		||||
    // it into the chain of pages
 | 
			
		||||
    wxCheckboxPage *page2 = new wxCheckboxPage(wizard, page1, page3);
 | 
			
		||||
    page1->SetNext(page2);
 | 
			
		||||
    page3->SetPrev(page2);
 | 
			
		||||
 | 
			
		||||
    if ( wizard->RunWizard(page1) )
 | 
			
		||||
    {
 | 
			
		||||
        wxMessageBox("The wizard successfully completed", "That's all",
 | 
			
		||||
                     wxICON_INFORMATION | wxOK);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    wizard->Destroy();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
void MyFrame::OnWizardCancel(wxWizardEvent& WXUNUSED(event))
 | 
			
		||||
{
 | 
			
		||||
    wxLogStatus(this, "The wizard was cancelled.");
 | 
			
		||||
}
 | 
			
		||||
		Reference in New Issue
	
	Block a user