/////////////////////////////////////////////////////////////////////////////
// Name: wizard.cpp
-// Purpose: wxWindows sample demonstrating wxWizard control
+// Purpose: wxWidgets sample demonstrating wxWizard control
// Author: Vadim Zeitlin
-// Modified by:
+// Modified by: Robert Vazan (sizers)
// Created: 15.08.99
-// RCS-ID: $Id$
// Copyright: (c) Vadim Zeitlin
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
// headers
// ----------------------------------------------------------------------------
-#if defined(__GNUG__) && !defined(__APPLE__)
- #pragma implementation "wizard.cpp"
- #pragma interface "wizard.cpp"
-#endif
-
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#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
+// for all others, include the necessary headers
#ifndef WX_PRECOMP
- #include "wx/wx.h"
+ #include "wx/frame.h"
+ #include "wx/stattext.h"
+ #include "wx/log.h"
+ #include "wx/app.h"
+ #include "wx/checkbox.h"
+ #include "wx/checklst.h"
+ #include "wx/msgdlg.h"
+ #include "wx/radiobox.h"
+ #include "wx/menu.h"
+ #include "wx/sizer.h"
#endif
+#include "wx/textctrl.h"
#include "wx/wizard.h"
-#ifndef __WXMSW__
- #include "wiztest.xpm"
- #include "wiztest2.xpm"
-#endif
+#include "wiztest.xpm"
+#include "wiztest2.xpm"
+
+#include "../sample.xpm"
// ----------------------------------------------------------------------------
// constants
// ids for menu items
enum
{
- Wizard_Quit = 100,
- Wizard_Run,
- Wizard_About = 1000
+ Wizard_About = wxID_ABOUT,
+ Wizard_Quit = wxID_EXIT,
+ Wizard_RunModal = wxID_HIGHEST,
+
+ Wizard_RunNoSizer,
+ Wizard_RunModeless,
+
+ Wizard_LargeWizard,
+ Wizard_ExpandBitmap
};
// ----------------------------------------------------------------------------
void OnQuit(wxCommandEvent& event);
void OnAbout(wxCommandEvent& event);
void OnRunWizard(wxCommandEvent& event);
+ void OnRunWizardNoSizer(wxCommandEvent& event);
+ void OnRunWizardModeless(wxCommandEvent& event);
void OnWizardCancel(wxWizardEvent& event);
+ void OnWizardFinished(wxWizardEvent& event);
private:
- // any class wishing to process wxWindows events must use this macro
+ // any class wishing to process wxWidgets events must use this macro
DECLARE_EVENT_TABLE()
};
+// ----------------------------------------------------------------------------
+// our wizard
+// ----------------------------------------------------------------------------
+
+class MyWizard : public wxWizard
+{
+public:
+ MyWizard(wxFrame *frame, bool useSizer = true);
+
+ wxWizardPage *GetFirstPage() const { return m_page1; }
+
+private:
+ wxWizardPageSimple *m_page1;
+};
+
// ----------------------------------------------------------------------------
// some pages for our wizard
// ----------------------------------------------------------------------------
-// this shows how to simply control the validity of the user input by just
+// 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
+// too.
//
-// it also shows how to use a different bitmap for one of the pages
+// 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 = wxBITMAP(wiztest2);
+ m_bitmap = wxBitmap(wiztest2_xpm);
+
+ m_checkbox = new wxCheckBox(this, wxID_ANY, wxT("&Check me"));
+
+ wxBoxSizer *mainSizer = new wxBoxSizer(wxVERTICAL);
+ mainSizer->Add(
+ new wxStaticText(this, wxID_ANY,
+ wxT("You need to check the checkbox\n")
+ wxT("below before going to the next page\n")),
+ 0,
+ wxALL,
+ 5
+ );
- m_checkbox = new wxCheckBox(this, -1, "&Check me");
+ mainSizer->Add(
+ m_checkbox,
+ 0, // No stretching
+ wxALL,
+ 5 // Border
+ );
+ SetSizerAndFit(mainSizer);
}
virtual bool TransferDataFromWindow()
{
if ( !m_checkbox->GetValue() )
{
- wxMessageBox("Check the checkbox first!", "No way",
+ wxMessageBox(wxT("Check the checkbox first!"), wxT("No way"),
wxICON_WARNING | wxOK, this);
- return FALSE;
+ return false;
}
- return TRUE;
+ return true;
}
private:
// 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";
+ choices[0] = wxT("forward");
+ choices[1] = wxT("backward");
+ choices[2] = wxT("both");
+ choices[3] = wxT("neither");
- m_radio = new wxRadioBox(this, -1, "Allow to proceed:",
- wxPoint(5, 5), wxDefaultSize,
+ m_radio = new wxRadioBox(this, wxID_ANY, wxT("Allow to proceed:"),
+ wxDefaultPosition, wxDefaultSize,
WXSIZEOF(choices), choices,
1, wxRA_SPECIFY_COLS);
m_radio->SetSelection(Both);
+
+ wxBoxSizer *mainSizer = new wxBoxSizer(wxVERTICAL);
+ mainSizer->Add(
+ m_radio,
+ 0, // No stretching
+ wxALL,
+ 5 // Border
+ );
+
+ SetSizerAndFit(mainSizer);
}
// wizard event handlers
void OnWizardCancel(wxWizardEvent& event)
{
- if ( wxMessageBox("Do you really want to cancel?", "Question",
+ if ( wxMessageBox(wxT("Do you really want to cancel?"), wxT("Question"),
wxICON_QUESTION | wxYES_NO, this) != wxYES )
{
// not confirmed
if ( !event.GetDirection() && sel == Backward )
return;
- wxMessageBox("You can't go there", "Not allowed",
+ wxMessageBox(wxT("You can't go there"), wxT("Not allowed"),
wxICON_WARNING | wxOK, this);
event.Veto();
DECLARE_EVENT_TABLE()
};
-// this shows how to dynamically (i.e. during run-time) arrange the page order
+// This shows how to dynamically (i.e. during run-time) arrange the page order.
class wxCheckboxPage : public wxWizardPage
{
public:
m_prev = prev;
m_next = next;
- (void)new wxStaticText(this, -1, "Try checking the box below and\n"
- "then going back and clearing it");
+ wxBoxSizer *mainSizer = new wxBoxSizer(wxVERTICAL);
+
+ mainSizer->Add(
+ new wxStaticText(this, wxID_ANY, wxT("Try checking the box below and\n")
+ wxT("then going back and clearing it")),
+ 0, // No vertical stretching
+ wxALL,
+ 5 // Border width
+ );
+
+ m_checkbox = new wxCheckBox(this, wxID_ANY, wxT("&Skip the next page"));
+ mainSizer->Add(
+ m_checkbox,
+ 0, // No vertical stretching
+ wxALL,
+ 5 // Border width
+ );
+
+#if wxUSE_CHECKLISTBOX
+ static const wxChar *aszChoices[] =
+ {
+ wxT("Zeroth"),
+ wxT("First"),
+ wxT("Second"),
+ wxT("Third"),
+ wxT("Fourth"),
+ wxT("Fifth"),
+ wxT("Sixth"),
+ wxT("Seventh"),
+ wxT("Eighth"),
+ wxT("Nineth")
+ };
+
+ m_checklistbox = new wxCheckListBox
+ (
+ this,
+ wxID_ANY,
+ wxDefaultPosition,
+ wxSize(100,100),
+ wxArrayString(WXSIZEOF(aszChoices), aszChoices)
+ );
+
+ mainSizer->Add(
+ m_checklistbox,
+ 0, // No vertical stretching
+ wxALL,
+ 5 // Border width
+ );
+#endif // wxUSE_CHECKLISTBOX
+
+ wxSize textSize = wxSize(150, 200);
+ if (((wxFrame*) wxTheApp->GetTopWindow())->GetMenuBar()->IsChecked(Wizard_LargeWizard))
+ textSize = wxSize(150, wxGetClientDisplayRect().GetHeight() - 200);
- m_checkbox = new wxCheckBox(this, -1, "&Skip the next page",
- wxPoint(5, 30));
+
+ wxTextCtrl* textCtrl = new wxTextCtrl(this, wxID_ANY, wxEmptyString, wxDefaultPosition, textSize, wxTE_MULTILINE);
+ mainSizer->Add(textCtrl, 0, wxALL|wxEXPAND, 5);
+
+ SetSizerAndFit(mainSizer);
}
// implement wxWizardPage functions
*m_next;
wxCheckBox *m_checkbox;
+#if wxUSE_CHECKLISTBOX
+ wxCheckListBox *m_checklistbox;
+#endif
};
// ============================================================================
// ----------------------------------------------------------------------------
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)
+ EVT_MENU(Wizard_Quit, MyFrame::OnQuit)
+ EVT_MENU(Wizard_About, MyFrame::OnAbout)
+ EVT_MENU(Wizard_RunModal, MyFrame::OnRunWizard)
+ EVT_MENU(Wizard_RunNoSizer, MyFrame::OnRunWizardNoSizer)
+ EVT_MENU(Wizard_RunModeless, MyFrame::OnRunWizardModeless)
+
+ EVT_WIZARD_CANCEL(wxID_ANY, MyFrame::OnWizardCancel)
+ EVT_WIZARD_FINISHED(wxID_ANY, MyFrame::OnWizardFinished)
END_EVENT_TABLE()
BEGIN_EVENT_TABLE(wxRadioboxPage, wxWizardPageSimple)
- EVT_WIZARD_PAGE_CHANGING(-1, wxRadioboxPage::OnWizardPageChanging)
- EVT_WIZARD_CANCEL(-1, wxRadioboxPage::OnWizardCancel)
+ EVT_WIZARD_PAGE_CHANGING(wxID_ANY, wxRadioboxPage::OnWizardPageChanging)
+ EVT_WIZARD_CANCEL(wxID_ANY, wxRadioboxPage::OnWizardCancel)
END_EVENT_TABLE()
IMPLEMENT_APP(MyApp)
// `Main program' equivalent: the program execution "starts" here
bool MyApp::OnInit()
{
- MyFrame *frame = new MyFrame("wxWizard Sample");
+ if ( !wxApp::OnInit() )
+ return false;
+
+ MyFrame *frame = new MyFrame(wxT("wxWizard Sample"));
// and show it (the frames, unlike simple controls, are not shown when
// created initially)
- frame->Show(TRUE);
+ frame->Show(true);
// we're done
- return TRUE;
+ return true;
+}
+
+// ----------------------------------------------------------------------------
+// MyWizard
+// ----------------------------------------------------------------------------
+
+MyWizard::MyWizard(wxFrame *frame, bool useSizer)
+{
+ SetExtraStyle(wxWIZARD_EX_HELPBUTTON);
+
+ Create(frame,wxID_ANY,wxT("Absolutely Useless Wizard"),
+ wxBitmap(wiztest_xpm),wxDefaultPosition,
+ wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER);
+ SetIcon(wxICON(sample));
+
+ // Allow the bitmap to be expanded to fit the page height
+ if (frame->GetMenuBar()->IsChecked(Wizard_ExpandBitmap))
+ SetBitmapPlacement(wxWIZARD_VALIGN_CENTRE);
+
+ // Enable scrolling adaptation
+ if (frame->GetMenuBar()->IsChecked(Wizard_LargeWizard))
+ SetLayoutAdaptationMode(wxDIALOG_ADAPTATION_MODE_ENABLED);
+
+ // a wizard page may be either an object of predefined class
+ m_page1 = new wxWizardPageSimple(this);
+
+ /* wxStaticText *text = */ new wxStaticText(m_page1, wxID_ANY,
+ wxT("This wizard doesn't help you\nto do anything at all.\n")
+ wxT("\n")
+ wxT("The next pages will present you\nwith more useless controls."),
+ wxPoint(5,5)
+ );
+
+ // ... or a derived class
+ wxRadioboxPage *page3 = new wxRadioboxPage(this);
+ wxValidationPage *page4 = new wxValidationPage(this);
+
+ // set the page order using a convenience function - could also use
+ // SetNext/Prev directly as below, but Chain() is shorter, avoids the risk
+ // of an error and can itself be chained, e.g. you could write
+ // page3.Chain(page4).Chain(page5) and so on.
+ page3->Chain(page4);
+
+ // this page is not a wxWizardPageSimple, so we use SetNext/Prev to insert
+ // it into the chain of pages
+ wxCheckboxPage *page2 = new wxCheckboxPage(this, m_page1, page3);
+ m_page1->SetNext(page2);
+ page3->SetPrev(page2);
+
+ if ( useSizer )
+ {
+ // allow the wizard to size itself around the pages
+ GetPageAreaSizer()->Add(m_page1);
+ }
}
// ----------------------------------------------------------------------------
// ----------------------------------------------------------------------------
MyFrame::MyFrame(const wxString& title)
- : wxFrame((wxFrame *)NULL, -1, title,
+ :wxFrame((wxFrame *)NULL, wxID_ANY, title,
wxDefaultPosition, wxSize(250, 150)) // small frame
{
wxMenu *menuFile = new wxMenu;
- menuFile->Append(Wizard_Run, "&Run wizard...\tCtrl-R");
+ menuFile->Append(Wizard_RunModal, wxT("&Run wizard modal...\tCtrl-R"));
+ menuFile->Append(Wizard_RunNoSizer, wxT("Run wizard &without sizer..."));
+ menuFile->Append(Wizard_RunModeless, wxT("Run wizard &modeless..."));
menuFile->AppendSeparator();
- menuFile->Append(Wizard_Quit, "E&xit\tAlt-X", "Quit this program");
+ menuFile->Append(Wizard_Quit, wxT("E&xit\tAlt-X"), wxT("Quit this program"));
+
+ wxMenu *menuOptions = new wxMenu;
+ menuOptions->AppendCheckItem(Wizard_LargeWizard, wxT("&Scroll Wizard Pages"));
+ menuOptions->AppendCheckItem(Wizard_ExpandBitmap, wxT("Si&ze Bitmap To Page"));
wxMenu *helpMenu = new wxMenu;
- helpMenu->Append(Wizard_About, "&About...\tF1", "Show about dialog");
+ helpMenu->Append(Wizard_About, wxT("&About\tF1"), wxT("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");
+ menuBar->Append(menuFile, wxT("&File"));
+ menuBar->Append(menuOptions, wxT("&Options"));
+ menuBar->Append(helpMenu, wxT("&Help"));
// ... and attach this menu bar to the frame
SetMenuBar(menuBar);
// also create status bar which we use in OnWizardCancel
+#if wxUSE_STATUSBAR
CreateStatusBar();
+#endif // wxUSE_STATUSBAR
}
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
{
- // TRUE is to force the frame to close
- Close(TRUE);
+ // 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);
+ wxMessageBox(wxT("Demo of wxWizard class\n")
+ wxT("(c) 1999, 2000 Vadim Zeitlin"),
+ wxT("About wxWizard sample"), wxOK | wxICON_INFORMATION, this);
}
void MyFrame::OnRunWizard(wxCommandEvent& WXUNUSED(event))
{
- wxWizard *wizard = new wxWizard(this, -1,
- "Absolutely Useless Wizard",
- wxBITMAP(wiztest));
-
- // a wizard page may be either an object of predefined class
- wxWizardPageSimple *page1 = new wxWizardPageSimple(wizard);
- wxStaticText *text = 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."
- );
- wxSize size = text->GetBestSize();
+ MyWizard wizard(this);
- // ... or a derived class
- wxRadioboxPage *page3 = new wxRadioboxPage(wizard);
- wxValidationPage *page4 = new wxValidationPage(wizard);
+ wizard.RunWizard(wizard.GetFirstPage());
+}
- // set the page order using a convenience function - could also use
- // SetNext/Prev directly as below
- wxWizardPageSimple::Chain(page3, page4);
+void MyFrame::OnRunWizardNoSizer(wxCommandEvent& WXUNUSED(event))
+{
+ MyWizard wizard(this, false);
- // 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);
+ wizard.RunWizard(wizard.GetFirstPage());
+}
- wizard->SetPageSize(size);
- if ( wizard->RunWizard(page1) )
- {
- wxMessageBox("The wizard successfully completed", "That's all",
- wxICON_INFORMATION | wxOK);
- }
+void MyFrame::OnRunWizardModeless(wxCommandEvent& WXUNUSED(event))
+{
+ MyWizard *wizard = new MyWizard(this);
+ wizard->ShowPage(wizard->GetFirstPage());
+ wizard->Show(true);
+}
- wizard->Destroy();
+void MyFrame::OnWizardFinished(wxWizardEvent& WXUNUSED(event))
+{
+ wxMessageBox(wxT("The wizard finished successfully."), wxT("Wizard notification"));
}
void MyFrame::OnWizardCancel(wxWizardEvent& WXUNUSED(event))
{
- wxLogStatus(this, wxT("The wizard was cancelled."));
+ wxMessageBox(wxT("The wizard was cancelled."), wxT("Wizard notification"));
}