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