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