]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/demo/Wizard.py
Renamed demo modules to be wx-less.
[wxWidgets.git] / wxPython / demo / Wizard.py
diff --git a/wxPython/demo/Wizard.py b/wxPython/demo/Wizard.py
new file mode 100644 (file)
index 0000000..7c7d5d8
--- /dev/null
@@ -0,0 +1,253 @@
+# 11/22/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# 
+# 11/3-/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o WizardPage* doesn't support GetId()
+# 
+
+import  wx
+import  wx.wizard   as  wiz
+import  images
+
+#----------------------------------------------------------------------
+
+def makePageTitle(wizPg, title):
+    sizer = wx.BoxSizer(wx.VERTICAL)
+    wizPg.SetSizer(sizer)
+    title = wx.StaticText(wizPg, -1, title)
+    title.SetFont(wx.Font(18, wx.SWISS, wx.NORMAL, wx.BOLD))
+    sizer.AddWindow(title, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
+    sizer.AddWindow(wx.StaticLine(wizPg, -1), 0, wx.EXPAND|wx.ALL, 5)
+    return sizer
+
+#----------------------------------------------------------------------
+
+class TitledPage(wiz.WizardPageSimple):
+    def __init__(self, parent, title):
+        wiz.WizardPageSimple.__init__(self, parent)
+        self.sizer = makePageTitle(self, title)
+
+
+#----------------------------------------------------------------------
+
+class SkipNextPage(wiz.PyWizardPage):
+    def __init__(self, parent, title):
+        wiz.PyWizardPage.__init__(self, parent)
+        self.next = self.prev = None
+        self.sizer = makePageTitle(self, title)
+
+        self.cb = wx.CheckBox(self, -1, "Skip next page")
+        self.sizer.Add(self.cb, 0, wx.ALL, 5)
+
+    def SetNext(self, next):
+        self.next = next
+
+    def SetPrev(self, prev):
+        self.prev = prev
+
+
+    # Classes derived from wxPyWizardPanel must override
+    # GetNext and GetPrev, and may also override GetBitmap
+    # as well as all those methods overridable by
+    # wx.PyWindow.
+
+    def GetNext(self):
+        """If the checkbox is set then return the next page's next page"""
+        next = self.next
+        if self.cb.GetValue():
+            next = next.GetNext()
+        return next
+
+    def GetPrev(self):
+        return self.prev
+
+#----------------------------------------------------------------------
+
+class UseAltBitmapPage(wiz.PyWizardPage):
+    def __init__(self, parent, title):
+        wiz.PyWizardPage.__init__(self, parent)
+        self.next = self.prev = None
+        self.sizer = makePageTitle(self, title)
+
+        self.sizer.Add(wx.StaticText(self, -1, "This page uses a different bitmap"),
+                       0, wx.ALL, 5)
+
+    def SetNext(self, next):
+        self.next = next
+
+    def SetPrev(self, prev):
+        self.prev = prev
+
+    def GetNext(self):
+        return self.next
+
+    def GetPrev(self):
+        return self.prev
+
+    def GetBitmap(self):
+        # You usually wouldn't need to override this method
+        # since you can set a non-default bitmap in the
+        # wxWizardPageSimple constructor, but if you need to
+        # dynamically change the bitmap based on the
+        # contents of the wizard, or need to also change the
+        # next/prev order then it can be done by overriding
+        # GetBitmap.
+        return images.getWizTest2Bitmap()
+
+#----------------------------------------------------------------------
+
+class TestPanel(wx.Panel):
+    ID_wiz = wx.NewId()
+
+    def __init__(self, parent, log):
+        self.log = log
+        wx.Panel.__init__(self, parent, -1)
+
+        b = wx.Button(self, -1, "Run Simple Wizard", pos=(50, 50))
+        self.Bind(wx.EVT_BUTTON, self.OnRunSimpleWizard, b)
+
+        b = wx.Button(self, -1, "Run Dynamic Wizard", pos=(50, 100))
+        self.Bind(wx.EVT_BUTTON, self.OnRunDynamicWizard, b)
+
+        wiz.EVT_WIZARD_PAGE_CHANGED(self, self.ID_wiz, self.OnWizPageChanged)
+        wiz.EVT_WIZARD_PAGE_CHANGING(self, self.ID_wiz, self.OnWizPageChanging)
+        wiz.EVT_WIZARD_CANCEL(self, self.ID_wiz, self.OnWizCancel)
+
+
+    def OnWizPageChanged(self, evt):
+        if evt.GetDirection():
+            dir = "forward"
+        else:
+            dir = "backward"
+
+        page = evt.GetPage()
+        self.log.write("OnWizPageChanged: %s, %s\n" % (dir, page.__class__))
+
+
+    def OnWizPageChanging(self, evt):
+        if evt.GetDirection():
+            dir = "forward"
+        else:
+            dir = "backward"
+
+        page = evt.GetPage()
+        self.log.write("OnWizPageChanging: %s, %s\n" % (dir, page.__class__))
+
+
+    def OnWizCancel(self, evt):
+        page = evt.GetPage()
+        self.log.write("OnWizCancel: %s\n" % page.__class__)
+
+        # Show how to prevent cancelling of the wizard.  The
+        # other events can be Veto'd too.
+        if page is self.page1:
+            wx.MessageBox("Cancelling on the first page has been prevented.", "Sorry")
+            evt.Veto()
+
+    def OnWizFinished(self, evt):
+        self.log.write("OnWizFinished\n")
+        
+
+    def OnRunSimpleWizard(self, evt):
+        # Create the wizard and the pages
+        wizard = wiz.Wizard(self, self.ID_wiz, "Simple Wizard",
+                          images.getWizTest1Bitmap())
+        page1 = TitledPage(wizard, "Page 1")
+        page2 = TitledPage(wizard, "Page 2")
+        page3 = TitledPage(wizard, "Page 3")
+        page4 = TitledPage(wizard, "Page 4")
+        self.page1 = page1
+
+        page1.sizer.Add(wx.StaticText(page1, -1, """
+This wizard is totally useless, but is meant to show how to
+chain simple wizard pages together in a non-dynamic manner.
+IOW, the order of the pages never changes, and so the
+wxWizardPageSimple class can easily be used for the pages."""))
+        wizard.FitToPage(page1)
+        page4.sizer.Add(wx.StaticText(page4, -1, "\nThis is the last page."))
+
+        # Use the convenience Chain function to connect the pages
+        wiz.WizardPageSimple_Chain(page1, page2)
+        wiz.WizardPageSimple_Chain(page2, page3)
+        wiz.WizardPageSimple_Chain(page3, page4)
+
+        if wizard.RunWizard(page1):
+            wx.MessageBox("Wizard completed successfully", "That's all folks!")
+        else:
+            wx.MessageBox("Wizard was cancelled", "That's all folks!")
+
+
+
+    def OnRunDynamicWizard(self, evt):
+        # Create the wizard and the pages
+        #wizard = wx.PreWizard()
+        #wizard.SetExtraStyle(wx.WIZARD_EX_HELPBUTTON)
+        #wizard.Create(self, self.ID_wiz, "Simple Wizard",
+        #              images.getWizTest1Bitmap())
+        wizard = wiz.Wizard(self, self.ID_wiz, "Simple Wizard",
+                          images.getWizTest1Bitmap())
+
+        page1 = TitledPage(wizard, "Page 1")
+        page2 = SkipNextPage(wizard, "Page 2")
+        page3 = TitledPage(wizard, "Page 3")
+        page4 = UseAltBitmapPage(wizard, "Page 4")
+        page5 = TitledPage(wizard, "Page 5")
+        self.page1 = page1
+
+        page1.sizer.Add(wx.StaticText(page1, -1, """
+This wizard shows the ability to choose at runtime the order
+of the pages and also which bitmap is shown.
+"""))
+        wizard.FitToPage(page1)
+        page5.sizer.Add(wx.StaticText(page5, -1, "\nThis is the last page."))
+
+        # Set the initial order of the pages
+        page1.SetNext(page2)
+        page2.SetPrev(page1)
+        page2.SetNext(page3)
+        page3.SetPrev(page2)
+        page3.SetNext(page4)
+        page4.SetPrev(page3)
+        page4.SetNext(page5)
+        page5.SetPrev(page4)
+
+
+        if wizard.RunWizard(page1):
+            wx.MessageBox("Wizard completed successfully", "That's all folks!")
+        else:
+            wx.MessageBox("Wizard was cancelled", "That's all folks!")
+
+#----------------------------------------------------------------------
+
+def runTest(frame, nb, log):
+    win = TestPanel(nb, log)
+    return win
+
+#----------------------------------------------------------------------
+
+
+
+overview = """<html><body>
+<h2><center>wxWizard</center></h2>
+
+wxWizard is the central class for implementing 'wizard-like'
+dialogs. These dialogs are mostly familiar to Windows users and are
+nothing else but a sequence of 'pages' each of them displayed inside a
+dialog which has the buttons to pass to the next (and previous) pages.
+<p>
+The wizards are typically used to decompose a complex dialog into
+several simple steps and are mainly useful to the novice users, hence
+it is important to keep them as simple as possible.
+
+</body></html>
+"""
+
+
+
+if __name__ == '__main__':
+    import sys,os
+    import run
+    run.main(['', os.path.basename(sys.argv[0])])
+