wxPython/demo/Main.py

   1 #!/bin/env python
   2 #----------------------------------------------------------------------------
   3 # Name:         Main.py
   4 # Purpose:      Testing lots of stuff, controls, window types, etc.
   5 #
   6 # Author:       Robin Dunn
   7 #
   8 # Created:      A long time ago, in a galaxy far, far away...
   9 # RCS-ID:       $Id$
  10 # Copyright:    (c) 1999 by Total Control Software
  11 # Licence:      wxWindows license
  12 #----------------------------------------------------------------------------
  13
  14 import sys, os, time, string
  15 from   wxPython.wx import *
  16 from   wxPython.html import wxHtmlWindow
  17
  18 import images
  19
  20 #---------------------------------------------------------------------------
  21
  22
  23 ## _treeList = [
  24 ##     ('New since last release', ['wxGenericDirCtrl',
  25 ##                                 'wxImageFromStream',
  26 ##                                 'RowColSizer',
  27 ##                                 'Unicode',
  28 ##                                 'wxFileHistory',
  29 ##                                 ]),
  30
  31 ##     ('Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame',
  32 ##                  'wxGrid', 'wxSashWindow',
  33 ##                  'wxScrolledWindow', 'wxSplitterWindow',
  34 ##                  'wxStatusBar', 'wxNotebook',
  35 ##                  'wxHtmlWindow',
  36 ##                  'wxStyledTextCtrl_1', 'wxStyledTextCtrl_2',
  37 ##                  'wxPopupWindow',
  38 ##                  'wxDynamicSashWindow',
  39 ##                  ]),
  40
  41 ##     ('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
  42 ##                         'wxSingleChoiceDialog', 'wxTextEntryDialog',
  43 ##                         'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
  44 ##                         'wxMessageDialog', 'wxProgressDialog', 'wxFindReplaceDialog',
  45 ##                         ]),
  46
  47 ##     ('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
  48 ##                   'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'VirtualListCtrl',
  49 ##                   'wxTextCtrl',
  50 ##                   'wxTreeCtrl', 'wxSpinButton', 'wxSpinCtrl', 'wxStaticText',
  51 ##                   'wxStaticBitmap', 'wxRadioBox', 'wxSlider', 'wxToolBar',
  52 ##                   'wxCalendarCtrl', 'wxToggleButton',
  53 ##                   'wxEditableListBox', 'wxLEDNumberCtrl',
  54 ##                   ]),
  55
  56 ##     ('Window Layout', ['wxLayoutConstraints', 'LayoutAnchors', 'Sizers', 'XML_Resource',
  57 ##                        'RowColSizer',
  58 ##                        ]),
  59
  60 ##     ('Miscellaneous', [ 'DragAndDrop', 'CustomDragAndDrop', 'URLDragAndDrop',
  61 ##                         'FontEnumerator',
  62 ##                         'wxTimer', 'wxValidator', 'wxGLCanvas', 'DialogUnits',
  63 ##                         'wxImage', 'wxMask', 'PrintFramework', 'wxOGL',
  64 ##                         'PythonEvents', 'Threads',
  65 ##                         'ActiveXWrapper_Acrobat', 'ActiveXWrapper_IE',
  66 ##                         'wxDragImage', "wxProcess", "FancyText", "OOR", "wxWave",
  67 ##                         'wxJoystick', 'DrawXXXList', 'ErrorDialogs', 'wxMimeTypesManager',
  68 ##                         'ContextHelp', 'SplitTree', 'Unicode', 'wxFileHistory',
  69 ##                         ]),
  70
  71 ##     ('wxPython Library', ['Layoutf', 'wxScrolledMessageDialog',
  72 ##                           'wxMultipleChoiceDialog', 'wxPlotCanvas', 'wxFloatBar',
  73 ##                           'wxCalendar', 'wxMVCTree', 'wxVTKRenderWindow',
  74 ##                           'FileBrowseButton', 'GenericButtons', 'wxEditor',
  75 ##                           'ColourSelect', 'ImageBrowser',
  76 ##                           'infoframe', 'ColourDB', 'PyCrust', 'PyCrustWithFilling',
  77 ##                           'TablePrint',
  78 ##                           'wxRightTextCtrl',
  79 ##                           ]),
  80
  81 ##     ('Cool Contribs', ['pyTree', 'hangman',
  82 ##                        #'SlashDot',
  83 ##                        'XMLtreeview'
  84 ##                        ]),
  85
  86 ##     ]
  87
  88
  89 _treeList = [
  90     # new stuff
  91     ('New since last release', [
  92         'RowColSizer',
  93         'Unicode',
  94         'wxFileHistory',
  95         'wxGenericDirCtrl',
  96         'wxImageFromStream',
  97         ]),
  98
  99     # managed windows == things with a caption you can close
 100     ('Base Frames and Dialogs', [
 101         'wxDialog',
 102         'wxFrame',
 103         'wxMDIWindows',
 104         'wxMiniFrame',
 105         ]),
 106
 107     # the common dialogs
 108     ('Common Dialogs', [
 109         'wxColourDialog',
 110         'wxDirDialog',
 111         'wxFileDialog',
 112         'wxFindReplaceDialog',
 113         'wxFontDialog',
 114         'wxMessageDialog',
 115         'wxPageSetupDialog',
 116         'wxPrintDialog',
 117         'wxProgressDialog',
 118         'wxSingleChoiceDialog',
 119         'wxTextEntryDialog',
 120         ]),
 121
 122     # dialogs form libraries
 123     ('More Dialogs', [
 124         'ErrorDialogs',
 125         'ImageBrowser',
 126         'wxMultipleChoiceDialog',
 127         'wxScrolledMessageDialog',
 128         ]),
 129
 130     # core controls
 131     ('Core Windows/Controls', [
 132         'VirtualListCtrl',
 133         'wxButton',
 134         'wxCheckBox',
 135         'wxCheckListBox',
 136         'wxChoice',
 137         'wxComboBox',
 138         'wxGauge',
 139         'wxGenericDirCtrl',
 140         'wxGrid',
 141         'wxListBox',
 142         'wxListCtrl',
 143         'wxNotebook',
 144         'wxPopupWindow',
 145         'wxRadioBox',
 146         'wxSashWindow',
 147         'wxSlider',
 148         'wxScrolledWindow',
 149         'wxSplitterWindow',
 150         'wxSpinButton',
 151         'wxSpinCtrl',
 152         'wxStaticText',
 153         'wxStaticBitmap',
 154         'wxStatusBar',
 155         'wxTextCtrl',
 156         'wxTimer',
 157         'wxToggleButton',
 158         'wxToolBar',
 159         'wxTreeCtrl',
 160         'wxValidator',
 161         ]),
 162
 163     # controls coming from other librairies
 164     ('More Windows/Controls', [
 165         'ColourSelect',
 166         'ContextHelp',
 167         'FancyText',
 168         'FileBrowseButton',
 169         'GenericButtons',
 170         'PyCrust',
 171         'PyCrustWithFilling',
 172         'SplitTree',
 173         'TablePrint',
 174         'wxCalendar',
 175         'wxCalendarCtrl',
 176         'wxDynamicSashWindow',
 177         'wxEditableListBox',
 178         'wxEditor',
 179         'wxFloatBar',
 180         'wxHtmlWindow',
 181         'wxLEDNumberCtrl',
 182         'wxMimeTypesManager',
 183         'wxMVCTree',
 184         'wxStyledTextCtrl_1',
 185         'wxStyledTextCtrl_2',
 186         'wxRightTextCtrl',
 187         ]),
 188
 189     # How to lay out the controls in a frame/dialog
 190     ('Window Layout', [
 191         'LayoutAnchors',
 192         'Layoutf',
 193         'RowColSizer',
 194         'Sizers',
 195         'wxLayoutConstraints',
 196         'XML_Resource',
 197         ]),
 198
 199     # ditto
 200     ('Process and Events', [
 201         'infoframe',
 202         'OOR',
 203         'PythonEvents',
 204         'Threads',
 205         'wxProcess',
 206         'wxTimer',
 207         ]),
 208
 209     # Clipboard and DnD
 210     ('Clipboard and DnD', [
 211         'CustomDragAndDrop',
 212         'DragAndDrop',
 213         'URLDragAndDrop',
 214         ]),
 215
 216     # Images
 217     ('Images', [
 218         'wxDragImage',
 219         'wxImage',
 220         'wxImageFromStream',
 221         'wxMask',
 222         ]),
 223
 224     # Other stuff
 225     ('Miscellaneous', [
 226         'ColourDB',
 227         'DialogUnits',
 228         'DrawXXXList',
 229         'FontEnumerator',
 230         'PrintFramework',
 231         'Unicode',
 232         'wxFileHistory',
 233         'wxJoystick',
 234         'wxOGL',
 235         'wxWave',
 236         ]),
 237
 238     # need libs not coming with the demo
 239     ('Objects using an external library', [
 240         'ActiveXWrapper_Acrobat',
 241         'ActiveXWrapper_IE',
 242         'wxGLCanvas',
 243         'wxPlotCanvas',
 244         'wxVTKRenderWindow',
 245         ]),
 246
 247     # pyTree, hangman, ... in the samples dir
 248     ('Check out the samples dir too', [
 249         ]),
 250
 251 ]
 252
 253
 254
 255 #---------------------------------------------------------------------------
 256
 257 class MyLog(wxPyLog):
 258     def __init__(self, textCtrl, logTime=0):
 259         wxPyLog.__init__(self)
 260         self.tc = textCtrl
 261         self.logTime = logTime
 262
 263     def DoLogString(self, message, timeStamp):
 264         if self.logTime:
 265             message = time.strftime("%X", time.localtime(timeStamp)) + \
 266                       ": " + message
 267         self.tc.AppendText(message + '\n')
 268
 269
 270 #---------------------------------------------------------------------------
 271
 272 def opj(path):
 273     """Convert paths to the platform-specific separator"""
 274     return apply(os.path.join, tuple(string.split(path, '/')))
 275
 276
 277 #---------------------------------------------------------------------------
 278
 279 class wxPythonDemo(wxFrame):
 280     overviewText = "wxPython Overview"
 281
 282     def __init__(self, parent, id, title):
 283         wxFrame.__init__(self, parent, -1, title, size = (800, 600),
 284                          style=wxDEFAULT_FRAME_STYLE|wxNO_FULL_REPAINT_ON_RESIZE)
 285
 286         self.cwd = os.getcwd()
 287         self.curOverview = ""
 288
 289         icon = images.getMondrianIcon()
 290         self.SetIcon(icon)
 291
 292         if wxPlatform == '__WXMSW__':
 293             # setup a taskbar icon, and catch some events from it
 294             self.tbicon = wxTaskBarIcon()
 295             self.tbicon.SetIcon(icon, "wxPython Demo")
 296             EVT_TASKBAR_LEFT_DCLICK(self.tbicon, self.OnTaskBarActivate)
 297             EVT_TASKBAR_RIGHT_UP(self.tbicon, self.OnTaskBarMenu)
 298             EVT_MENU(self.tbicon, self.TBMENU_RESTORE, self.OnTaskBarActivate)
 299             EVT_MENU(self.tbicon, self.TBMENU_CLOSE, self.OnTaskBarClose)
 300
 301
 302         self.otherWin = None
 303         self.showTip = true
 304         EVT_IDLE(self, self.OnIdle)
 305         EVT_CLOSE(self, self.OnCloseWindow)
 306         EVT_ICONIZE(self, self.OnIconfiy)
 307         EVT_MAXIMIZE(self, self.OnMaximize)
 308
 309         self.Centre(wxBOTH)
 310         self.CreateStatusBar(1, wxST_SIZEGRIP)
 311
 312         splitter = wxSplitterWindow(self, -1, style=wxNO_3D|wxSP_3D)
 313         splitter2 = wxSplitterWindow(splitter, -1, style=wxNO_3D|wxSP_3D)
 314
 315         def EmptyHandler(evt): pass
 316         EVT_ERASE_BACKGROUND(splitter, EmptyHandler)
 317         EVT_ERASE_BACKGROUND(splitter2, EmptyHandler)
 318
 319         # Prevent TreeCtrl from displaying all items after destruction when true
 320         self.dying = false
 321
 322         # Make a File menu
 323         self.mainmenu = wxMenuBar()
 324         menu = wxMenu()
 325         exitID = wxNewId()
 326         menu.Append(exitID, 'E&xit\tAlt-X', 'Get the heck outta here!')
 327         EVT_MENU(self, exitID, self.OnFileExit)
 328         self.mainmenu.Append(menu, '&File')
 329
 330         # Make a Demo menu
 331         menu = wxMenu()
 332         for item in _treeList:
 333             submenu = wxMenu()
 334             for childItem in item[1]:
 335                 mID = wxNewId()
 336                 submenu.Append(mID, childItem)
 337                 EVT_MENU(self, mID, self.OnDemoMenu)
 338             menu.AppendMenu(wxNewId(), item[0], submenu)
 339         self.mainmenu.Append(menu, '&Demo')
 340
 341
 342         # Make a Help menu
 343         helpID = wxNewId()
 344         menu = wxMenu()
 345         menu.Append(helpID, '&About\tCtrl-H', 'wxPython RULES!!!')
 346         EVT_MENU(self, helpID, self.OnHelpAbout)
 347         self.mainmenu.Append(menu, '&Help')
 348         self.SetMenuBar(self.mainmenu)
 349
 350         # set the menu accellerator table...
 351         aTable = wxAcceleratorTable([(wxACCEL_ALT,  ord('X'), exitID),
 352                                      (wxACCEL_CTRL, ord('H'), helpID)])
 353         self.SetAcceleratorTable(aTable)
 354
 355
 356         # Create a TreeCtrl
 357         tID = wxNewId()
 358         self.treeMap = {}
 359         self.tree = wxTreeCtrl(splitter, tID,
 360                                style=wxTR_HAS_BUTTONS |
 361                                wxTR_EDIT_LABELS |
 362                                wxTR_HAS_VARIABLE_ROW_HEIGHT)
 363
 364         #self.tree.SetBackgroundColour(wxNamedColour("Pink"))
 365         root = self.tree.AddRoot("wxPython Overview")
 366         firstChild = None
 367         for item in _treeList:
 368             child = self.tree.AppendItem(root, item[0])
 369             if not firstChild: firstChild = child
 370             for childItem in item[1]:
 371                 theDemo = self.tree.AppendItem(child, childItem)
 372                 self.treeMap[childItem] = theDemo
 373
 374         self.tree.Expand(root)
 375         self.tree.Expand(firstChild)
 376         EVT_TREE_ITEM_EXPANDED   (self.tree, tID, self.OnItemExpanded)
 377         EVT_TREE_ITEM_COLLAPSED  (self.tree, tID, self.OnItemCollapsed)
 378         EVT_TREE_SEL_CHANGED     (self.tree, tID, self.OnSelChanged)
 379         EVT_LEFT_DOWN            (self.tree,      self.OnTreeLeftDown)
 380
 381         # Create a Notebook
 382         self.nb = wxNotebook(splitter2, -1, style=wxCLIP_CHILDREN)
 383
 384         # Set up a wxHtmlWindow on the Overview Notebook page
 385         # we put it in a panel first because there seems to be a
 386         # refresh bug of some sort (wxGTK) when it is directly in
 387         # the notebook...
 388         if 0:  # the old way
 389             self.ovr = wxHtmlWindow(self.nb, -1, size=(400, 400))
 390             self.nb.AddPage(self.ovr, self.overviewText)
 391
 392         else:  # hopefully I can remove this hacky code soon, see bug #216861
 393             panel = wxPanel(self.nb, -1, style=wxCLIP_CHILDREN)
 394             self.ovr = wxHtmlWindow(panel, -1, size=(400, 400))
 395             self.nb.AddPage(panel, self.overviewText)
 396
 397             def OnOvrSize(evt, ovr=self.ovr):
 398                 ovr.SetSize(evt.GetSize())
 399
 400             EVT_SIZE(panel, OnOvrSize)
 401             EVT_ERASE_BACKGROUND(panel, EmptyHandler)
 402
 403
 404         self.SetOverview(self.overviewText, overview)
 405
 406
 407         # Set up a TextCtrl on the Demo Code Notebook page
 408         self.txt = wxTextCtrl(self.nb, -1,
 409                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 410         self.nb.AddPage(self.txt, "Demo Code")
 411
 412
 413         # Set up a log on the View Log Notebook page
 414         self.log = wxTextCtrl(splitter2, -1,
 415                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 416
 417         # Set the wxWindows log target to be this textctrl
 418         #wxLog_SetActiveTarget(wxLogTextCtrl(self.log))
 419
 420         # But instead of the above we want to show how to use our own wxLog class
 421         wxLog_SetActiveTarget(MyLog(self.log))
 422
 423
 424
 425         self.Show(true)
 426
 427         # add the windows to the splitter and split it.
 428         splitter2.SplitHorizontally(self.nb, self.log)
 429         splitter.SplitVertically(self.tree, splitter2)
 430
 431         splitter.SetSashPosition(180, true)
 432         splitter.SetMinimumPaneSize(20)
 433         splitter2.SetSashPosition(450, true)
 434         splitter2.SetMinimumPaneSize(20)
 435
 436
 437
 438         # select initial items
 439         self.nb.SetSelection(0)
 440         self.tree.SelectItem(root)
 441
 442         if len(sys.argv) == 2:
 443             try:
 444                 selectedDemo = self.treeMap[sys.argv[1]]
 445             except:
 446                 selectedDemo = None
 447             if selectedDemo:
 448                 self.tree.SelectItem(selectedDemo)
 449                 self.tree.EnsureVisible(selectedDemo)
 450
 451
 452         wxLogMessage('window handle: %s' % self.GetHandle())
 453
 454
 455     #---------------------------------------------
 456     def WriteText(self, text):
 457         if text[-1:] == '\n':
 458             text = text[:-1]
 459         wxLogMessage(text)
 460
 461
 462     def write(self, txt):
 463         self.WriteText(txt)
 464
 465     #---------------------------------------------
 466     def OnItemExpanded(self, event):
 467         item = event.GetItem()
 468         wxLogMessage("OnItemExpanded: %s" % self.tree.GetItemText(item))
 469         event.Skip()
 470
 471     #---------------------------------------------
 472     def OnItemCollapsed(self, event):
 473         item = event.GetItem()
 474         wxLogMessage("OnItemCollapsed: %s" % self.tree.GetItemText(item))
 475         event.Skip()
 476
 477     #---------------------------------------------
 478     def OnTreeLeftDown(self, event):
 479         pt = event.GetPosition();
 480         item, flags = self.tree.HitTest(pt)
 481         if item == self.tree.GetSelection():
 482             self.SetOverview(self.tree.GetItemText(item)+" Overview", self.curOverview)
 483         event.Skip()
 484
 485     #---------------------------------------------
 486     def OnSelChanged(self, event):
 487         if self.dying:
 488             return
 489
 490         item = event.GetItem()
 491         itemText = self.tree.GetItemText(item)
 492         self.RunDemo(itemText)
 493
 494
 495     #---------------------------------------------
 496     def RunDemo(self, itemText):
 497         os.chdir(self.cwd)
 498         if self.nb.GetPageCount() == 3:
 499             if self.nb.GetSelection() == 2:
 500                 self.nb.SetSelection(0)
 501             self.nb.DeletePage(2)
 502
 503         if itemText == self.overviewText:
 504             self.GetDemoFile('Main.py')
 505             self.SetOverview(self.overviewText, overview)
 506             self.nb.Refresh();
 507             self.window = None
 508
 509         else:
 510             if os.path.exists(itemText + '.py'):
 511                 wxBeginBusyCursor()
 512                 wxLogMessage("Running demo %s.py..." % itemText)
 513                 try:
 514                     self.GetDemoFile(itemText + '.py')
 515                     module = __import__(itemText, globals())
 516                     self.SetOverview(itemText + " Overview", module.overview)
 517                 finally:
 518                     wxEndBusyCursor()
 519
 520                 # in case runTest is modal, make sure things look right...
 521                 self.nb.Refresh();
 522                 wxYield()
 523
 524                 self.window = module.runTest(self, self.nb, self) ###
 525                 if self.window:
 526                     self.nb.AddPage(self.window, 'Demo')
 527                     #wxYield()  TODO: Is this still needed?
 528                     self.nb.SetSelection(2)
 529                     self.nb.Refresh()  # without this wxMac has troubles showing the just added page
 530
 531             else:
 532                 self.ovr.SetPage("")
 533                 self.txt.Clear()
 534                 self.window = None
 535
 536
 537
 538     #---------------------------------------------
 539     # Get the Demo files
 540     def GetDemoFile(self, filename):
 541         self.txt.Clear()
 542         try:
 543             self.txt.SetValue(open(filename).read())
 544         except IOError:
 545             self.txt.WriteText("Cannot open %s file." % filename)
 546
 547         self.txt.SetInsertionPoint(0)
 548         self.txt.ShowPosition(0)
 549
 550     #---------------------------------------------
 551     def SetOverview(self, name, text):
 552         self.curOverview = text
 553         lead = text[:6]
 554         if lead != '<html>' and lead != '<HTML>':
 555             text = string.join(string.split(text, '\n'), '<br>')
 556         self.ovr.SetPage(text)
 557         self.nb.SetPageText(0, name)
 558
 559     #---------------------------------------------
 560     # Menu methods
 561     def OnFileExit(self, *event):
 562         self.Close()
 563
 564
 565     def OnHelpAbout(self, event):
 566         from About import MyAboutBox
 567         about = MyAboutBox(self)
 568         about.ShowModal()
 569         about.Destroy()
 570
 571
 572     #---------------------------------------------
 573     def OnCloseWindow(self, event):
 574         self.dying = true
 575         self.window = None
 576         self.mainmenu = None
 577         if hasattr(self, "tbicon"):
 578             del self.tbicon
 579         self.Destroy()
 580
 581
 582     #---------------------------------------------
 583     def OnIdle(self, event):
 584         if self.otherWin:
 585             self.otherWin.Raise()
 586             self.window = self.otherWin
 587             self.otherWin = None
 588
 589         if self.showTip:
 590             self.ShowTip()
 591             self.showTip = false
 592
 593
 594     #---------------------------------------------
 595     def ShowTip(self):
 596         try:
 597             showTipText = open(opj("data/showTips")).read()
 598             showTip, index = eval(showTipText)
 599         except IOError:
 600             showTip, index = (1, 0)
 601         if showTip:
 602             tp = wxCreateFileTipProvider(opj("data/tips.txt"), index)
 603             showTip = wxShowTip(self, tp)
 604             index = tp.GetCurrentTip()
 605             open(opj("data/showTips"), "w").write(str( (showTip, index) ))
 606
 607
 608     #---------------------------------------------
 609     def OnDemoMenu(self, event):
 610         try:
 611             selectedDemo = self.treeMap[self.mainmenu.GetLabel(event.GetId())]
 612         except:
 613             selectedDemo = None
 614         if selectedDemo:
 615             self.tree.SelectItem(selectedDemo)
 616             self.tree.EnsureVisible(selectedDemo)
 617
 618
 619     #---------------------------------------------
 620     def OnTaskBarActivate(self, evt):
 621         if self.IsIconized():
 622             self.Iconize(false)
 623         if not self.IsShown():
 624             self.Show(true)
 625         self.Raise()
 626
 627     #---------------------------------------------
 628
 629     TBMENU_RESTORE = 1000
 630     TBMENU_CLOSE   = 1001
 631
 632     def OnTaskBarMenu(self, evt):
 633         menu = wxMenu()
 634         menu.Append(self.TBMENU_RESTORE, "Restore wxPython Demo")
 635         menu.Append(self.TBMENU_CLOSE,   "Close")
 636         self.tbicon.PopupMenu(menu)
 637         menu.Destroy()
 638
 639     #---------------------------------------------
 640     def OnTaskBarClose(self, evt):
 641         self.Close()
 642
 643         # because of the way wxTaskBarIcon.PopupMenu is implemented we have to
 644         # prod the main idle handler a bit to get the window to actually close
 645         wxGetApp().ProcessIdle()
 646
 647
 648     #---------------------------------------------
 649     def OnIconfiy(self, evt):
 650         wxLogMessage("OnIconfiy")
 651         evt.Skip()
 652
 653     #---------------------------------------------
 654     def OnMaximize(self, evt):
 655         wxLogMessage("OnMaximize")
 656         evt.Skip()
 657
 658
 659
 660
 661 #---------------------------------------------------------------------------
 662 #---------------------------------------------------------------------------
 663
 664 class MySplashScreen(wxSplashScreen):
 665     def __init__(self):
 666         bmp = wxImage(opj("bitmaps/splash.gif")).ConvertToBitmap()
 667         wxSplashScreen.__init__(self, bmp,
 668                                 wxSPLASH_CENTRE_ON_SCREEN|wxSPLASH_TIMEOUT,
 669                                 4000, None, -1)
 670         EVT_CLOSE(self, self.OnClose)
 671
 672     def OnClose(self, evt):
 673         frame = wxPythonDemo(None, -1, "wxPython: (A Demonstration)")
 674         frame.Show(true)
 675         evt.Skip()  # Make sure the default handler runs too...
 676
 677
 678 class MyApp(wxApp):
 679     def OnInit(self):
 680         """
 681         Create and show the splash screen.  It will then create and show
 682         the main frame when it is time to do so.
 683         """
 684         wxInitAllImageHandlers()
 685         splash = MySplashScreen()
 686         splash.Show()
 687         return true
 688
 689
 690
 691 #---------------------------------------------------------------------------
 692
 693 def main():
 694     try:
 695         demoPath = os.path.dirname(__file__)
 696         os.chdir(demoPath)
 697     except:
 698         pass
 699     app = MyApp(0)
 700     app.MainLoop()
 701
 702
 703 #---------------------------------------------------------------------------
 704
 705
 706
 707 overview = """<html><body>
 708  <h2>Python</h2>
 709
 710  Python is an interpreted, interactive, object-oriented programming
 711  language often compared to Tcl, Perl, Scheme, or Java.
 712
 713  <p> Python combines remarkable power with very clear syntax. It has
 714  modules, classes, exceptions, very high level dynamic data types, and
 715  dynamic typing.  There are interfaces to many system calls and
 716  libraries, and new built-in modules are easily written in C or
 717  C++. Python is also usable as an extension language for applications
 718  that need a programmable interface.  <p>
 719
 720  <h2>wxWindows</h2>
 721
 722  wxWindows is a free C++ framework designed to make cross-platform
 723  programming child's play. Well, almost. wxWindows 2 supports Windows
 724  3.1/95/98/NT, Unix with GTK/Motif/Lesstif, with a Mac version
 725  underway. Other ports are under consideration.  <p>
 726
 727  wxWindows is a set of libraries that allows C++ applications to
 728  compile and run on several different types of computers, with minimal
 729  source code changes.  There is one library per supported GUI (such as
 730  Motif, or Windows). As well as providing a common API (Application
 731  Programming Interface) for GUI functionality, it provides
 732  functionality for accessing some commonly-used operating system
 733  facilities, such as copying or deleting files. wxWindows is a
 734  'framework' in the sense that it provides a lot of built-in
 735  functionality, which the application can use or replace as required,
 736  thus saving a great deal of coding effort. Basic data structures such
 737  as strings, linked lists and hash tables are also supported.
 738
 739  <p>
 740  <h2>wxPython</h2>
 741
 742  wxPython is a Python extension module that encapsulates the wxWindows
 743  GUI classes. Currently it is only available for the Win32 and GTK
 744  ports of wxWindows, but as soon as the other ports are brought up to
 745  the same level as Win32 and GTK, it should be fairly trivial to
 746  enable wxPython to be used with the new GUI.
 747
 748  <p>
 749
 750  The wxPython extension module attempts to mirror the class heiarchy
 751  of wxWindows as closely as possible. This means that there is a
 752  wxFrame class in wxPython that looks, smells, tastes and acts almost
 753  the same as the wxFrame class in the C++ version. Unfortunately,
 754  because of differences in the languages, wxPython doesn't match
 755  wxWindows exactly, but the differences should be easy to absorb
 756  because they are natural to Python. For example, some methods that
 757  return multiple values via argument pointers in C++ will return a
 758  tuple of values in Python.
 759
 760  <p>
 761
 762  There is still much to be done for wxPython, many classes still need
 763  to be mirrored. Also, wxWindows is still somewhat of a moving target
 764  so it is a bit of an effort just keeping wxPython up to date. On the
 765  other hand, there are enough of the core classes completed that
 766  useful applications can be written.
 767
 768  <p>
 769
 770  wxPython is close enough to the C++ version that the majority of
 771  the wxPython documentation is actually just notes attached to the C++
 772  documents that describe the places where wxPython is different. There
 773  is also a series of sample programs included, and a series of
 774  documentation pages that assist the programmer in getting started
 775  with wxPython.
 776
 777  """
 778
 779
 780 #----------------------------------------------------------------------------
 781 #----------------------------------------------------------------------------
 782
 783 if __name__ == '__main__':
 784     main()
 785
 786 #----------------------------------------------------------------------------
 787
 788
 789
 790
 791
 792
 793