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     ('New since last release', ['wxMVCTree', 'wxVTKRenderWindow']),
  25
  26     ('Managed Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame']),
  27
  28     ('Non-Managed Windows', ['wxGrid', 'wxSashWindow',
  29                                'wxScrolledWindow', 'wxSplitterWindow',
  30                                'wxStatusBar', 'wxToolBar', 'wxNotebook',
  31                                'wxHtmlWindow']),
  32
  33     ('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
  34                         'wxSingleChoiceDialog', 'wxTextEntryDialog',
  35                         'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
  36                         'wxMessageDialog', 'wxProgressDialog']),
  37
  38     ('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
  39                   'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'wxTextCtrl',
  40                   'wxTreeCtrl', 'wxSpinButton', 'wxStaticText', 'wxStaticBitmap',
  41                   'wxRadioBox', 'wxSlider']),
  42
  43     ('Window Layout', ['wxLayoutConstraints', 'Sizers', 'OldSizers']),
  44
  45     ('Miscellaneous', [ 'DragAndDrop', 'CustomDragAndDrop', 'FontEnumerator',
  46                         'wxTimer', 'wxValidator', 'wxGLCanvas', 'DialogUnits',
  47                         'wxImage', 'PrintFramework', 'wxOGL', 'PythonEvents',
  48                         'Threads']),
  49
  50     ('wxPython Library', ['Layoutf', 'wxScrolledMessageDialog',
  51                           'wxMultipleChoiceDialog', 'wxPlotCanvas', 'wxFloatBar',
  52                           'PyShell', 'wxCalendar', 'wxMVCTree', 'wxVTKRenderWindow']),
  53
  54     ('Cool Contribs', ['pyTree', 'hangman', 'SlashDot', 'XMLtreeview']),
  55
  56     ]
  57
  58 #---------------------------------------------------------------------------
  59
  60 class wxPythonDemo(wxFrame):
  61     def __init__(self, parent, id, title):
  62         wxFrame.__init__(self, parent, -1, title, size = (725, 550))
  63
  64         if wxPlatform == '__WXMSW__':
  65             self.icon = wxIcon('bitmaps/mondrian.ico', wxBITMAP_TYPE_ICO)
  66             self.SetIcon(self.icon)
  67
  68         self.otherWin = None
  69         EVT_IDLE(self, self.OnIdle)
  70
  71         self.Centre(wxBOTH)
  72         self.CreateStatusBar(1, wxST_SIZEGRIP)
  73
  74         if _useSplitter:
  75             splitter = wxSplitterWindow(self, -1)
  76             if _useNestedSplitter:
  77                 splitter2 = wxSplitterWindow(splitter, -1)
  78                 logParent = nbParent = splitter2
  79             else:
  80                 nbParent = splitter
  81                 logParent = wxFrame(self, -1, "wxPython Demo: log window",
  82                                 (0,0), (500, 150))
  83                 logParent.Show(true)
  84         else:
  85             nbParent = self
  86             logParent = wxFrame(self, -1, "wxPython Demo: log window",
  87                                 (0,0), (500, 150))
  88             logParent.Show(true)
  89
  90
  91
  92         # Prevent TreeCtrl from displaying all items after destruction
  93         self.dying = false
  94
  95         # Make a File menu
  96         self.mainmenu = wxMenuBar()
  97         menu = wxMenu()
  98         exitID = wxNewId()
  99         menu.Append(exitID, 'E&xit\tAlt-X', 'Get the heck outta here!')
 100         EVT_MENU(self, exitID, self.OnFileExit)
 101         self.mainmenu.Append(menu, '&File')
 102
 103         # Make a Demo menu
 104         menu = wxMenu()
 105         for item in _treeList:
 106             submenu = wxMenu()
 107             for childItem in item[1]:
 108                 mID = wxNewId()
 109                 submenu.Append(mID, childItem)
 110                 EVT_MENU(self, mID, self.OnDemoMenu)
 111             menu.AppendMenu(wxNewId(), item[0], submenu)
 112         self.mainmenu.Append(menu, '&Demo')
 113
 114
 115         # Make a Help menu
 116         helpID = wxNewId()
 117         menu = wxMenu()
 118         menu.Append(helpID, '&About\tCtrl-H', 'wxPython RULES!!!')
 119         EVT_MENU(self, helpID, self.OnHelpAbout)
 120         self.mainmenu.Append(menu, '&Help')
 121         self.SetMenuBar(self.mainmenu)
 122
 123         # set the menu accellerator table...
 124         aTable = wxAcceleratorTable([(wxACCEL_ALT,  ord('X'), exitID),
 125                                      (wxACCEL_CTRL, ord('H'), helpID)])
 126         self.SetAcceleratorTable(aTable)
 127
 128
 129         # Create a TreeCtrl
 130         if _useSplitter:
 131             tID = wxNewId()
 132             self.treeMap = {}
 133             self.tree = wxTreeCtrl(splitter, tID)
 134             root = self.tree.AddRoot("Overview")
 135             for item in _treeList:
 136                 child = self.tree.AppendItem(root, item[0])
 137                 for childItem in item[1]:
 138                     theDemo = self.tree.AppendItem(child, childItem)
 139                     self.treeMap[childItem] = theDemo
 140
 141             self.tree.Expand(root)
 142             EVT_TREE_ITEM_EXPANDED   (self.tree, tID, self.OnItemExpanded)
 143             EVT_TREE_ITEM_COLLAPSED  (self.tree, tID, self.OnItemCollapsed)
 144             EVT_TREE_SEL_CHANGED     (self.tree, tID, self.OnSelChanged)
 145
 146         # Create a Notebook
 147         self.nb = wxNotebook(nbParent, -1)
 148
 149         # Set up a TextCtrl on the Overview Notebook page
 150         self.ovr = wxTextCtrl(self.nb, -1, style = wxTE_MULTILINE|wxTE_READONLY)
 151         self.nb.AddPage(self.ovr, "Overview")
 152
 153
 154         # Set up a TextCtrl on the Demo Code Notebook page
 155         self.txt = wxTextCtrl(self.nb, -1,
 156                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 157         self.txt.SetFont(wxFont(9, wxMODERN, wxNORMAL, wxNORMAL, false))
 158         self.nb.AddPage(self.txt, "Demo Code")
 159
 160
 161         # Set up a log on the View Log Notebook page
 162         self.log = wxTextCtrl(logParent, -1,
 163                               style = wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL)
 164         (w, self.charHeight) = self.log.GetTextExtent('X')
 165         self.WriteText('wxPython Demo Log:\n')
 166
 167         self.Show(true)
 168
 169         # add the windows to the splitter and split it.
 170         if _useSplitter:
 171             if _useNestedSplitter:
 172                 splitter2.SplitHorizontally(self.nb, self.log)
 173                 splitter2.SetSashPosition(360, true)
 174                 splitter2.SetMinimumPaneSize(20)
 175
 176                 splitter.SplitVertically(self.tree, splitter2)
 177             else:
 178                 splitter.SplitVertically(self.tree, self.nb)
 179
 180             splitter.SetSashPosition(180, true)
 181             splitter.SetMinimumPaneSize(20)
 182
 183
 184         # make our log window be stdout
 185         #sys.stdout = self
 186
 187         # select initial items
 188         self.nb.SetSelection(0)
 189         if _useSplitter:
 190             self.tree.SelectItem(root)
 191
 192         if len(sys.argv) == 2:
 193             try:
 194                 selectedDemo = self.treeMap[sys.argv[1]]
 195             except:
 196                 selectedDemo = None
 197             if selectedDemo and _useSplitter:
 198                 self.tree.SelectItem(selectedDemo)
 199                 self.tree.EnsureVisible(selectedDemo)
 200
 201
 202         self.WriteText('window handle: %s\n' % self.GetHandle())
 203
 204
 205     #---------------------------------------------
 206     def WriteText(self, text):
 207         self.log.WriteText(text)
 208         w, h = self.log.GetClientSizeTuple()
 209         numLines = h/self.charHeight
 210         x, y = self.log.PositionToXY(self.log.GetLastPosition())
 211         if y > numLines:
 212             self.log.ShowPosition(self.log.XYToPosition(x, y-numLines))
 213             ##self.log.ShowPosition(self.log.GetLastPosition())
 214         self.log.SetInsertionPointEnd()
 215
 216     def write(self, txt):
 217         self.WriteText(txt)
 218
 219     #---------------------------------------------
 220     def OnItemExpanded(self, event):
 221         item = event.GetItem()
 222         self.log.WriteText("OnItemExpanded: %s\n" % self.tree.GetItemText(item))
 223
 224     #---------------------------------------------
 225     def OnItemCollapsed(self, event):
 226         item = event.GetItem()
 227         self.log.WriteText("OnItemCollapsed: %s\n" % self.tree.GetItemText(item))
 228
 229     #---------------------------------------------
 230     def OnSelChanged(self, event):
 231         if self.dying:
 232             return
 233
 234         item = event.GetItem()
 235         itemText = self.tree.GetItemText(item)
 236         self.RunDemo(itemText)
 237
 238
 239     #---------------------------------------------
 240     def RunDemo(self, itemText):
 241         if self.nb.GetPageCount() == 3:
 242             if self.nb.GetSelection() == 2:
 243                 self.nb.SetSelection(0)
 244             self.nb.DeletePage(2)
 245
 246         if itemText == 'Overview':
 247             self.GetDemoFile('Main.py')
 248             self.SetOverview('Overview', overview)
 249             self.nb.Refresh();
 250             self.window = None
 251
 252         else:
 253             if os.path.exists(itemText + '.py'):
 254                 wxBeginBusyCursor()
 255                 self.GetDemoFile(itemText + '.py')
 256                 module = __import__(itemText, globals())
 257                 self.SetOverview(itemText, module.overview)
 258                 wxEndBusyCursor()
 259
 260                 # in case runTest is modal, make sure things look right...
 261                 self.nb.Refresh();
 262                 wxYield()
 263
 264                 self.window = module.runTest(self, self.nb, self)
 265                 if self.window:
 266                     self.nb.AddPage(self.window, 'Demo')
 267                     #self.nb.ResizeChildren()
 268                     self.nb.SetSelection(2)
 269                     #self.nb.ResizeChildren()
 270                     #if self.window.GetAutoLayout():
 271                     #    self.window.Layout()
 272
 273             else:
 274                 self.ovr.Clear()
 275                 self.txt.Clear()
 276                 self.window = None
 277
 278
 279
 280     #---------------------------------------------
 281     # Get the Demo files
 282     def GetDemoFile(self, filename):
 283         self.txt.Clear()
 284         #if not self.txt.LoadFile(filename):
 285         #    self.txt.WriteText("Cannot open %s file." % filename)
 286         try:
 287             self.txt.SetValue(open(filename).read())
 288         except IOError:
 289             self.txt.WriteText("Cannot open %s file." % filename)
 290
 291
 292         self.txt.SetInsertionPoint(0)
 293         self.txt.ShowPosition(0)
 294
 295     #---------------------------------------------
 296     def SetOverview(self, name, text):
 297         self.ovr.Clear()
 298         self.ovr.WriteText(text)
 299         self.nb.SetPageText(0, name)
 300         self.ovr.SetInsertionPoint(0)
 301         self.ovr.ShowPosition(0)
 302
 303     #---------------------------------------------
 304     # Menu methods
 305     def OnFileExit(self, event):
 306         self.Close()
 307
 308
 309     def OnHelpAbout(self, event):
 310         #about = wxMessageDialog(self,
 311         #                        "wxPython is a Python extension module that\n"
 312         #                        "encapsulates the wxWindows GUI classes.\n\n"
 313         #                        "This demo shows off some of the capabilities\n"
 314         #                        "of wxPython.\n\n"
 315         #                        "          Developed by Robin Dunn",
 316         #                       "About wxPython", wxOK)
 317         from About import MyAboutBox
 318         about = MyAboutBox(self)
 319         about.ShowModal()
 320         about.Destroy()
 321
 322
 323     #---------------------------------------------
 324     def OnCloseWindow(self, event):
 325         self.dying = true
 326         self.window = None
 327         self.mainmenu = None
 328         self.Destroy()
 329
 330     #---------------------------------------------
 331     def OnIdle(self, event):
 332         if self.otherWin:
 333             self.otherWin.Raise()
 334             self.window = self.otherWin
 335             self.otherWin = None
 336
 337     #---------------------------------------------
 338     def OnDemoMenu(self, event):
 339         if _useSplitter:
 340             try:
 341                 selectedDemo = self.treeMap[self.mainmenu.GetLabel(event.GetId())]
 342             except:
 343                 selectedDemo = None
 344             if selectedDemo:
 345                 self.tree.SelectItem(selectedDemo)
 346                 self.tree.EnsureVisible(selectedDemo)
 347         else:
 348             self.RunDemo(self.mainmenu.GetLabel(event.GetId()))
 349
 350 #---------------------------------------------------------------------------
 351 #---------------------------------------------------------------------------
 352
 353 class MyApp(wxApp):
 354     def OnInit(self):
 355         wxImage_AddHandler(wxJPEGHandler())
 356         wxImage_AddHandler(wxPNGHandler())
 357         wxImage_AddHandler(wxGIFHandler())
 358         frame = wxPythonDemo(NULL, -1, "wxPython: (A Demonstration)")
 359         frame.Show(true)
 360         self.SetTopWindow(frame)
 361         return true
 362
 363 #---------------------------------------------------------------------------
 364
 365 def main():
 366     app = MyApp(0)
 367     app.MainLoop()
 368
 369
 370 #---------------------------------------------------------------------------
 371
 372
 373
 374 overview = """\
 375 Python
 376 ------------
 377
 378 Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.
 379
 380 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.
 381
 382 wxWindows
 383 --------------------
 384
 385 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.
 386
 387 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.
 388
 389 wxPython
 390 ----------------
 391
 392 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.
 393
 394 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.
 395
 396 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.
 397
 398 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.
 399 """
 400
 401
 402
 403
 404
 405
 406
 407 #----------------------------------------------------------------------------
 408 #----------------------------------------------------------------------------
 409
 410 if __name__ == '__main__':
 411     main()
 412
 413 #----------------------------------------------------------------------------
 414
 415
 416
 417
 418
 419
 420