utils/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 & Gary Dumer
   7 #
   8 # Created:
   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
  17
  18 #---------------------------------------------------------------------------
  19
  20 _useSplitter       = true
  21 _useNestedSplitter = true
  22
  23 _treeList = [
  24     ('Managed Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame']),
  25
  26     ('Miscellaneous Windows', ['wxGrid', 'wxSashWindow',
  27                                'wxScrolledWindow', 'wxSplitterWindow',
  28                                'wxStatusBar', 'wxToolBar', 'wxNotebook',
  29                                'wxHtmlWindow']),
  30
  31     ('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
  32                         'wxSingleChoiceDialog', 'wxTextEntryDialog',
  33                         'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
  34                         'wxMessageDialog', 'wxProgressDialog']),
  35
  36     ('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
  37                   'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'wxTextCtrl',
  38                   'wxTreeCtrl', 'wxSpinButton', 'wxStaticText', 'wxStaticBitmap',
  39                   'wxRadioBox', 'wxSlider']),
  40
  41     ('Window Layout', ['wxLayoutConstraints', 'Sizers', 'OldSizers']),
  42
  43     ('Miscellaneous', ['wxTimer', 'wxValidator', 'wxGLCanvas', 'DialogUnits',
  44                        'wxImage', 'PrintFramework', 'wxOGL']),
  45
  46     ('wxPython Library', ['OldSizers', 'Layoutf', 'wxScrolledMessageDialog',
  47                           'wxMultipleChoiceDialog', 'wxPlotCanvas', 'wxFloatBar',
  48                           'PyShell']),
  49
  50     ('Cool Contribs', ['pyTree', 'hangman', 'SlashDot', 'XMLtreeview']),
  51
  52     ]
  53
  54 #---------------------------------------------------------------------------
  55
  56 class wxPythonDemo(wxFrame):
  57     def __init__(self, parent, id, title):
  58         wxFrame.__init__(self, parent, -1, title, size = (725, 550))
  59
  60         if wxPlatform == '__WXMSW__':
  61             self.icon = wxIcon('bitmaps/mondrian.ico', wxBITMAP_TYPE_ICO)
  62             self.SetIcon(self.icon)
  63
  64         self.otherWin = None
  65         EVT_IDLE(self, self.OnIdle)
  66
  67         self.Centre(wxBOTH)
  68         self.CreateStatusBar(1, wxST_SIZEGRIP)
  69
  70         if _useSplitter:
  71             splitter = wxSplitterWindow(self, -1)
  72             if _useNestedSplitter:
  73                 splitter2 = wxSplitterWindow(splitter, -1)
  74                 logParent = nbParent = splitter2
  75             else:
  76                 nbParent = splitter
  77                 logParent = wxFrame(self, -1, "wxPython Demo: log window",
  78                                 (0,0), (500, 150))
  79                 logParent.Show(true)
  80         else:
  81             nbParent = self
  82             logParent = wxFrame(self, -1, "wxPython Demo: log window",
  83                                 (0,0), (500, 150))
  84             logParent.Show(true)
  85
  86
  87
  88         # Prevent TreeCtrl from displaying all items after destruction
  89         self.dying = false
  90
  91         # Make a File menu
  92         self.mainmenu = wxMenuBar()
  93         menu = wxMenu()
  94         exitID = wxNewId()
  95         menu.Append(exitID, 'E&xit\tAlt-X', 'Get the heck outta here!')
  96         EVT_MENU(self, exitID, self.OnFileExit)
  97         self.mainmenu.Append(menu, '&File')
  98
  99         # Make a Demo menu
 100         menu = wxMenu()
 101         for item in _treeList:
 102             submenu = wxMenu()
 103             for childItem in item[1]:
 104                 mID = wxNewId()
 105                 submenu.Append(mID, childItem)
 106                 EVT_MENU(self, mID, self.OnDemoMenu)
 107             menu.AppendMenu(wxNewId(), item[0], submenu)
 108         self.mainmenu.Append(menu, '&Demo')
 109
 110
 111         # Make a Help menu
 112         helpID = wxNewId()
 113         menu = wxMenu()
 114         menu.Append(helpID, '&About\tCtrl-H', 'wxPython RULES!!!')
 115         EVT_MENU(self, helpID, self.OnHelpAbout)
 116         self.mainmenu.Append(menu, '&Help')
 117         self.SetMenuBar(self.mainmenu)
 118
 119         # set the menu accellerator table...
 120         aTable = wxAcceleratorTable([(wxACCEL_ALT,  ord('X'), exitID),
 121                                      (wxACCEL_CTRL, ord('H'), helpID)])
 122         self.SetAcceleratorTable(aTable)
 123
 124
 125         # Create a TreeCtrl
 126         if _useSplitter:
 127             tID = wxNewId()
 128             self.treeMap = {}
 129             self.tree = wxTreeCtrl(splitter, tID)
 130             root = self.tree.AddRoot("Overview")
 131             for item in _treeList:
 132                 child = self.tree.AppendItem(root, item[0])
 133                 for childItem in item[1]:
 134                     theDemo = self.tree.AppendItem(child, childItem)
 135                     self.treeMap[childItem] = theDemo
 136
 137             self.tree.Expand(root)
 138             EVT_TREE_ITEM_EXPANDED   (self.tree, tID, self.OnItemExpanded)
 139             EVT_TREE_ITEM_COLLAPSED  (self.tree, tID, self.OnItemCollapsed)
 140             EVT_TREE_SEL_CHANGED     (self.tree, tID, self.OnSelChanged)
 141
 142         # Create a Notebook
 143         self.nb = wxNotebook(nbParent, -1)
 144
 145         # Set up a TextCtrl on the Overview Notebook page
 146         self.ovr = wxTextCtrl(self.nb, -1, style = wxTE_MULTILINE|wxTE_READONLY)
 147         self.nb.AddPage(self.ovr, "Overview")
 148
 149
 150         # Set up a TextCtrl on the Demo Code Notebook page
 151         self.txt = wxTextCtrl(self.nb, -1,
 152                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 153         self.txt.SetFont(wxFont(9, wxMODERN, wxNORMAL, wxNORMAL, false))
 154         self.nb.AddPage(self.txt, "Demo Code")
 155
 156
 157         # Set up a log on the View Log Notebook page
 158         self.log = wxTextCtrl(logParent, -1,
 159                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 160         (w, self.charHeight) = self.log.GetTextExtent('X')
 161         self.WriteText('wxPython Demo Log:\n')
 162
 163
 164         # add the windows to the splitter and split it.
 165         if _useSplitter:
 166             if _useNestedSplitter:
 167                 splitter2.SplitHorizontally(self.nb, self.log)
 168                 splitter2.SetSashPosition(360, true)
 169                 splitter2.SetMinimumPaneSize(20)
 170
 171                 splitter.SplitVertically(self.tree, splitter2)
 172             else:
 173                 splitter.SplitVertically(self.tree, self.nb)
 174
 175             splitter.SetSashPosition(180, true)
 176             splitter.SetMinimumPaneSize(20)
 177
 178
 179         # make our log window be stdout
 180         #sys.stdout = self
 181
 182         # select initial items
 183         self.nb.SetSelection(0)
 184         if _useSplitter:
 185             self.tree.SelectItem(root)
 186
 187         if len(sys.argv) == 2:
 188             try:
 189                 selectedDemo = self.treeMap[sys.argv[1]]
 190             except:
 191                 selectedDemo = None
 192             if selectedDemo and _useSplitter:
 193                 self.tree.SelectItem(selectedDemo)
 194                 self.tree.EnsureVisible(selectedDemo)
 195
 196
 197     #---------------------------------------------
 198     def WriteText(self, text):
 199         self.log.WriteText(text)
 200         w, h = self.log.GetClientSizeTuple()
 201         numLines = h/self.charHeight
 202         x, y = self.log.PositionToXY(self.log.GetLastPosition())
 203         if y > numLines:
 204             self.log.ShowPosition(self.log.XYToPosition(x, y-numLines))
 205             ##self.log.ShowPosition(self.log.GetLastPosition())
 206         self.log.SetInsertionPointEnd()
 207
 208     def write(self, txt):
 209         self.WriteText(txt)
 210
 211     #---------------------------------------------
 212     def OnItemExpanded(self, event):
 213         item = event.GetItem()
 214         self.log.WriteText("OnItemExpanded: %s\n" % self.tree.GetItemText(item))
 215
 216     #---------------------------------------------
 217     def OnItemCollapsed(self, event):
 218         item = event.GetItem()
 219         self.log.WriteText("OnItemCollapsed: %s\n" % self.tree.GetItemText(item))
 220
 221     #---------------------------------------------
 222     def OnSelChanged(self, event):
 223         if self.dying:
 224             return
 225
 226         item = event.GetItem()
 227         itemText = self.tree.GetItemText(item)
 228         self.RunDemo(itemText)
 229
 230
 231     #---------------------------------------------
 232     def RunDemo(self, itemText):
 233         if self.nb.GetPageCount() == 3:
 234             if self.nb.GetSelection() == 2:
 235                 self.nb.SetSelection(0)
 236             self.nb.DeletePage(2)
 237
 238         if itemText == 'Overview':
 239             self.GetDemoFile('Main.py')
 240             self.SetOverview('Overview', overview)
 241             self.nb.Refresh();
 242             self.window = None
 243
 244         else:
 245             if os.path.exists(itemText + '.py'):
 246                 wxBeginBusyCursor()
 247                 self.GetDemoFile(itemText + '.py')
 248                 module = __import__(itemText, globals())
 249                 self.SetOverview(itemText, module.overview)
 250                 wxEndBusyCursor()
 251
 252                 # in case runTest is modal, make sure things look right...
 253                 self.nb.Refresh();
 254                 wxYield()
 255
 256                 self.window = module.runTest(self, self.nb, self)
 257                 if self.window:
 258                     self.nb.AddPage(self.window, 'Demo')
 259                     #self.nb.ResizeChildren()
 260                     self.nb.SetSelection(2)
 261                     #self.nb.ResizeChildren()
 262                     #if self.window.GetAutoLayout():
 263                     #    self.window.Layout()
 264
 265             else:
 266                 self.ovr.Clear()
 267                 self.txt.Clear()
 268                 self.window = None
 269
 270
 271
 272     #---------------------------------------------
 273     # Get the Demo files
 274     def GetDemoFile(self, filename):
 275         self.txt.Clear()
 276         #if not self.txt.LoadFile(filename):
 277         #    self.txt.WriteText("Cannot open %s file." % filename)
 278         try:
 279             self.txt.SetValue(open(filename).read())
 280         except IOError:
 281             self.txt.WriteText("Cannot open %s file." % filename)
 282
 283
 284         self.txt.SetInsertionPoint(0)
 285         self.txt.ShowPosition(0)
 286
 287     #---------------------------------------------
 288     def SetOverview(self, name, text):
 289         self.ovr.Clear()
 290         self.ovr.WriteText(text)
 291         self.nb.SetPageText(0, name)
 292         self.ovr.SetInsertionPoint(0)
 293         self.ovr.ShowPosition(0)
 294
 295     #---------------------------------------------
 296     # Menu methods
 297     def OnFileExit(self, event):
 298         self.Close()
 299
 300
 301     def OnHelpAbout(self, event):
 302         #about = wxMessageDialog(self,
 303         #                        "wxPython is a Python extension module that\n"
 304         #                        "encapsulates the wxWindows GUI classes.\n\n"
 305         #                        "This demo shows off some of the capabilities\n"
 306         #                        "of wxPython.\n\n"
 307         #                        "          Developed by Robin Dunn",
 308         #                       "About wxPython", wxOK)
 309         from About import MyAboutBox
 310         about = MyAboutBox(self)
 311         about.ShowModal()
 312         about.Destroy()
 313
 314
 315     #---------------------------------------------
 316     def OnCloseWindow(self, event):
 317         self.dying = true
 318         self.window = None
 319         self.mainmenu = None
 320         self.Destroy()
 321
 322     #---------------------------------------------
 323     def OnIdle(self, event):
 324         if self.otherWin:
 325             self.otherWin.Raise()
 326             self.window = self.otherWin
 327             self.otherWin = None
 328
 329     #---------------------------------------------
 330     def OnDemoMenu(self, event):
 331         if _useSplitter:
 332             try:
 333                 selectedDemo = self.treeMap[self.mainmenu.GetLabel(event.GetId())]
 334             except:
 335                 selectedDemo = None
 336             if selectedDemo:
 337                 self.tree.SelectItem(selectedDemo)
 338                 self.tree.EnsureVisible(selectedDemo)
 339         else:
 340             self.RunDemo(self.mainmenu.GetLabel(event.GetId()))
 341
 342 #---------------------------------------------------------------------------
 343 #---------------------------------------------------------------------------
 344
 345 class MyApp(wxApp):
 346     def OnInit(self):
 347         wxImage_AddHandler(wxJPEGHandler())
 348         wxImage_AddHandler(wxPNGHandler())
 349         wxImage_AddHandler(wxGIFHandler())
 350         frame = wxPythonDemo(NULL, -1, "wxPython: (A Demonstration)")
 351         frame.Show(true)
 352         self.SetTopWindow(frame)
 353         return true
 354
 355 #---------------------------------------------------------------------------
 356
 357 def main():
 358     app = MyApp(0)
 359     app.MainLoop()
 360
 361
 362 #---------------------------------------------------------------------------
 363
 364
 365
 366 overview = """\
 367 Python
 368 ------------
 369
 370 Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.
 371
 372 Python combines remarkable power with very clear syntax. It has modules, classes, exceptions, very high level dynamic data types, and dynamic typing. There are interfaces to many system calls and libraries, and new built-in modules are easily written in C or C++. Python is also usable as an extension language for applications that need a programmable interface.
 373
 374 wxWindows
 375 --------------------
 376
 377 wxWindows is a free C++ framework designed to make cross-platform programming child's play. Well, almost. wxWindows 2 supports Windows 3.1/95/98/NT, Unix with GTK/Motif/Lesstif, with a Mac version underway. Other ports are under consideration.
 378
 379 wxWindows is a set of libraries that allows C++ applications to compile and run on several different types of computers, with minimal source code changes. There is one library per supported GUI (such as Motif, or Windows). As well as providing a common API (Application Programming Interface) for GUI functionality, it provides functionality for accessing some commonly-used operating system facilities, such as copying or deleting files. wxWindows is a 'framework' in the sense that it provides a lot of built-in functionality, which the application can use or replace as required, thus saving a great deal of coding effort. Basic data structures such as strings, linked lists and hash tables are also supported.
 380
 381 wxPython
 382 ----------------
 383
 384 wxPython is a Python extension module that encapsulates the wxWindows GUI classes. Currently it is only available for the Win32 and GTK ports of wxWindows, but as soon as the other ports are brought up to the same level as Win32 and GTK, it should be fairly trivial to enable wxPython to be used with the new GUI.
 385
 386 The wxPython extension module attempts to mirror the class heiarchy of wxWindows as closely as possible. This means that there is a wxFrame class in wxPython that looks, smells, tastes and acts almost the same as the wxFrame class in the C++ version. Unfortunately, because of differences in the languages, wxPython doesn't match wxWindows exactly, but the differences should be easy to absorb because they are natural to Python. For example, some methods that return multiple values via argument pointers in C++ will return a tuple of values in Python.
 387
 388 There is still much to be done for wxPython, many classes still need to be mirrored. Also, wxWindows is still somewhat of a moving target so it is a bit of an effort just keeping wxPython up to date. On the other hand, there are enough of the core classes completed that useful applications can be written.
 389
 390 wxPython is close enough to the C++ version that the majority of the wxPython documentation is actually just notes attached to the C++ documents that describe the places where wxPython is different. There is also a series of sample programs included, and a series of documentation pages that assist the programmer in getting started with wxPython.
 391 """
 392
 393
 394
 395
 396
 397
 398
 399 #----------------------------------------------------------------------------
 400 #----------------------------------------------------------------------------
 401
 402 if __name__ == '__main__':
 403     main()
 404
 405 #----------------------------------------------------------------------------
 406
 407
 408
 409
 410
 411
 412