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