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