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