#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
// ----------------------------------------------------------------------------
virtual bool OnInit();
};
-IMPLEMENT_APP(MyApp)
+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
// overriding TransferDataFromWindow() - of course, in a real program, the
// check wouldn't be so trivial and the data will be probably saved somewhere
// too
-class wxCheckboxPage : public wxPanel
+//
+// it also shows how to use a different bitmap for one of the pages
+class wxValidationPage : public wxWizardPageSimple
{
public:
- wxCheckboxPage(wxWizard *parent) : wxPanel(parent)
+ wxValidationPage(wxWizard *parent) : wxWizardPageSimple(parent)
{
- m_checkbox = new wxCheckBox(this, -1, "Check me", wxPoint(20, 20));
+ m_bitmap = BMP_WIZARD_2;
+
+ m_checkbox = new wxCheckBox(this, -1, "&Check me");
}
virtual bool TransferDataFromWindow()
{
- if ( m_checkbox->GetValue() )
+ if ( !m_checkbox->GetValue() )
{
- wxMessageBox("Clear the checkbox first", "No way",
+ wxMessageBox("Check the checkbox first!", "No way",
wxICON_WARNING | wxOK, this);
return FALSE;
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" };
+
+ 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()
{
-#ifdef __WXMSW__
- wxBitmap bmpWizard("wiztest.bmp", wxBITMAP_TYPE_BMP);
-#else
- wxBitmap bmpWizard(wizimage);
-#endif
+ MyFrame *frame = new MyFrame("wxWizard Sample");
+
+ // and show it (the frames, unlike simple controls, are not shown when
+ // created initially)
+ frame->Show(TRUE);
- wxWizard *wizard = wxWizard::Create(NULL, -1,
+ // 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"
+ "© 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",
- bmpWizard);
+ BMP_WIZARD_1);
- wxPanel *panel = new wxPanel(wizard);
- (void)new wxStaticText(panel, -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.");
- wizard->AddPage(panel);
- wizard->AddPage(new wxCheckboxPage(wizard));
+ // ... 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() )
+ if ( wizard->RunWizard(page1) )
{
wxMessageBox("The wizard successfully completed", "That's all",
wxICON_INFORMATION | wxOK);
}
wizard->Destroy();
+}
- // we're done
- return FALSE;
+void MyFrame::OnWizardCancel(wxWizardEvent& WXUNUSED(event))
+{
+ wxLogStatus(this, "The wizard was cancelled.");
}
projects / wxWidgets.git / blobdiff