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']),
  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+1))
 157
 158     def write(self, txt):
 159         self.WriteText(txt)
 160
 161     #---------------------------------------------
 162     def OnItemExpanded(self, event):
 163         item = event.GetItem()
 164         self.log.WriteText("OnItemExpanded: %s\n" % self.tree.GetItemText(item))
 165
 166     #---------------------------------------------
 167     def OnItemCollapsed(self, event):
 168         item = event.GetItem()
 169         self.log.WriteText("OnItemCollapsed: %s\n" % self.tree.GetItemText(item))
 170
 171     #---------------------------------------------
 172     def OnSelChanged(self, event):
 173         if self.dying:
 174             return
 175
 176         if self.nb.GetPageCount() == 3:
 177             if self.nb.GetSelection() == 2:
 178                 self.nb.SetSelection(0)
 179             self.nb.DeletePage(2)
 180
 181         item = event.GetItem()
 182         itemText = self.tree.GetItemText(item)
 183
 184         if itemText == 'Overview':
 185             self.GetDemoFile('Main.py')
 186             self.SetOverview('Overview', overview)
 187             #self.nb.ResizeChildren();
 188             self.nb.Refresh();
 189             #wxYield()
 190
 191         else:
 192             if os.path.exists(itemText + '.py'):
 193                 self.GetDemoFile(itemText + '.py')
 194                 module = __import__(itemText, globals())
 195                 self.SetOverview(itemText, module.overview)
 196
 197                 # in case runTest is modal, make sure things look right...
 198                 self.nb.Refresh();
 199                 wxYield()
 200
 201                 window = module.runTest(self, self.nb, self)
 202                 if window:
 203                     self.nb.AddPage(window, 'Demo')
 204                     self.nb.SetSelection(2)
 205                     self.nb.ResizeChildren();
 206
 207             else:
 208                 self.ovr.Clear()
 209                 self.txt.Clear()
 210
 211
 212     #---------------------------------------------
 213     # Get the Demo files
 214     def GetDemoFile(self, filename):
 215         self.txt.Clear()
 216         #if not self.txt.LoadFile(filename):
 217         #    self.txt.WriteText("Cannot open %s file." % filename)
 218         try:
 219             self.txt.SetValue(open(filename).read())
 220         except IOException:
 221             self.txt.WriteText("Cannot open %s file." % filename)
 222
 223
 224         self.txt.SetInsertionPoint(0)
 225         self.txt.ShowPosition(0)
 226
 227     #---------------------------------------------
 228     def SetOverview(self, name, text):
 229         self.ovr.Clear()
 230         self.ovr.WriteText(text)
 231         self.nb.SetPageText(0, name)
 232         self.ovr.SetInsertionPoint(0)
 233         self.ovr.ShowPosition(0)
 234
 235     #---------------------------------------------
 236     # Menu methods
 237     def OnFileExit(self, event):
 238         self.Close()
 239
 240
 241     def OnHelpAbout(self, event):
 242         about = wxMessageDialog(self,
 243                                 "wxPython is a Python extension module that\n"
 244                                 "encapsulates the wxWindows GUI classes.\n\n"
 245                                 "This demo shows off some of the capabilities\n"
 246                                 "of wxPython.\n\n"
 247                                 "          Developed by Robin Dunn",
 248                                "About wxPython", wxOK)
 249         about.ShowModal()
 250         about.Destroy()
 251
 252
 253     #---------------------------------------------
 254     def OnCloseWindow(self, event):
 255         self.dying = true
 256         self.Destroy()
 257
 258     #---------------------------------------------
 259     def OnIdle(self, event):
 260         if self.otherWin:
 261             self.otherWin.Raise()
 262             self.otherWin = None
 263
 264
 265 #---------------------------------------------------------------------------
 266 #---------------------------------------------------------------------------
 267
 268 class MyApp(wxApp):
 269     def OnInit(self):
 270         wxImage_AddHandler(wxJPEGHandler())
 271         wxImage_AddHandler(wxPNGHandler())
 272         wxImage_AddHandler(wxGIFHandler())
 273         frame = wxPythonDemo(NULL, -1, "wxPython: (A Demonstration)")
 274         frame.Show(true)
 275         self.SetTopWindow(frame)
 276         return true
 277
 278 #---------------------------------------------------------------------------
 279
 280 def main():
 281     app = MyApp(0)
 282     app.MainLoop()
 283
 284
 285 #---------------------------------------------------------------------------
 286
 287
 288
 289 overview = """\
 290 Python
 291 ------------
 292
 293 Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.
 294
 295 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.
 296
 297 wxWindows
 298 --------------------
 299
 300 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.
 301
 302 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.
 303
 304 wxPython
 305 ----------------
 306
 307 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.
 308
 309 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.
 310
 311 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.
 312
 313 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.
 314 """
 315
 316
 317
 318
 319
 320
 321
 322 #----------------------------------------------------------------------------
 323 #----------------------------------------------------------------------------
 324
 325 if __name__ == '__main__':
 326     main()
 327
 328 #----------------------------------------------------------------------------
 329
 330
 331
 332
 333
 334
 335