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