2 #----------------------------------------------------------------------------
4 # Purpose: Testing lots of stuff, controls, window types, etc.
6 # Author: Robin Dunn & Gary Dumer
10 # Copyright: (c) 1999 by Total Control Software
11 # Licence: wxWindows license
12 #----------------------------------------------------------------------------
15 from wxPython
.wx
import *
18 #---------------------------------------------------------------------------
21 _useNestedSplitter
= true
24 ('Managed Windows', ['wxFrame', 'wxDialog', 'wxMiniFrame']),
26 ('Non-Managed Windows', ['wxGrid', 'wxSashWindow',
27 'wxScrolledWindow', 'wxSplitterWindow',
28 'wxStatusBar', 'wxToolBar', 'wxNotebook',
31 ('Common Dialogs', ['wxColourDialog', 'wxDirDialog', 'wxFileDialog',
32 'wxSingleChoiceDialog', 'wxTextEntryDialog',
33 'wxFontDialog', 'wxPageSetupDialog', 'wxPrintDialog',
34 'wxMessageDialog', 'wxProgressDialog']),
36 ('Controls', ['wxButton', 'wxCheckBox', 'wxCheckListBox', 'wxChoice',
37 'wxComboBox', 'wxGauge', 'wxListBox', 'wxListCtrl', 'wxTextCtrl',
38 'wxTreeCtrl', 'wxSpinButton', 'wxStaticText', 'wxStaticBitmap',
39 'wxRadioBox', 'wxSlider']),
41 ('Window Layout', ['wxLayoutConstraints', 'Sizers', 'OldSizers']),
43 ('Miscellaneous', [ 'DragAndDrop', 'CustomDragAndDrop', 'FontEnumerator',
44 'wxTimer', 'wxValidator', 'wxGLCanvas', 'DialogUnits',
45 'wxImage', 'PrintFramework', 'wxOGL', 'PythonEvents',
48 ('wxPython Library', ['Layoutf', 'wxScrolledMessageDialog',
49 'wxMultipleChoiceDialog', 'wxPlotCanvas', 'wxFloatBar',
50 'PyShell', 'wxCalendar']),
52 ('Cool Contribs', ['pyTree', 'hangman', 'SlashDot', 'XMLtreeview']),
56 #---------------------------------------------------------------------------
58 class wxPythonDemo(wxFrame
):
59 def __init__(self
, parent
, id, title
):
60 wxFrame
.__init
__(self
, parent
, -1, title
, size
= (725, 550))
62 if wxPlatform
== '__WXMSW__':
63 self
.icon
= wxIcon('bitmaps/mondrian.ico', wxBITMAP_TYPE_ICO
)
64 self
.SetIcon(self
.icon
)
67 EVT_IDLE(self
, self
.OnIdle
)
70 self
.CreateStatusBar(1, wxST_SIZEGRIP
)
73 splitter
= wxSplitterWindow(self
, -1)
74 if _useNestedSplitter
:
75 splitter2
= wxSplitterWindow(splitter
, -1)
76 logParent
= nbParent
= splitter2
79 logParent
= wxFrame(self
, -1, "wxPython Demo: log window",
84 logParent
= wxFrame(self
, -1, "wxPython Demo: log window",
90 # Prevent TreeCtrl from displaying all items after destruction
94 self
.mainmenu
= wxMenuBar()
97 menu
.Append(exitID
, 'E&xit\tAlt-X', 'Get the heck outta here!')
98 EVT_MENU(self
, exitID
, self
.OnFileExit
)
99 self
.mainmenu
.Append(menu
, '&File')
103 for item
in _treeList
:
105 for childItem
in item
[1]:
107 submenu
.Append(mID
, childItem
)
108 EVT_MENU(self
, mID
, self
.OnDemoMenu
)
109 menu
.AppendMenu(wxNewId(), item
[0], submenu
)
110 self
.mainmenu
.Append(menu
, '&Demo')
116 menu
.Append(helpID
, '&About\tCtrl-H', 'wxPython RULES!!!')
117 EVT_MENU(self
, helpID
, self
.OnHelpAbout
)
118 self
.mainmenu
.Append(menu
, '&Help')
119 self
.SetMenuBar(self
.mainmenu
)
121 # set the menu accellerator table...
122 aTable
= wxAcceleratorTable([(wxACCEL_ALT
, ord('X'), exitID
),
123 (wxACCEL_CTRL
, ord('H'), helpID
)])
124 self
.SetAcceleratorTable(aTable
)
131 self
.tree
= wxTreeCtrl(splitter
, tID
)
132 root
= self
.tree
.AddRoot("Overview")
133 for item
in _treeList
:
134 child
= self
.tree
.AppendItem(root
, item
[0])
135 for childItem
in item
[1]:
136 theDemo
= self
.tree
.AppendItem(child
, childItem
)
137 self
.treeMap
[childItem
] = theDemo
139 self
.tree
.Expand(root
)
140 EVT_TREE_ITEM_EXPANDED (self
.tree
, tID
, self
.OnItemExpanded
)
141 EVT_TREE_ITEM_COLLAPSED (self
.tree
, tID
, self
.OnItemCollapsed
)
142 EVT_TREE_SEL_CHANGED (self
.tree
, tID
, self
.OnSelChanged
)
145 self
.nb
= wxNotebook(nbParent
, -1)
147 # Set up a TextCtrl on the Overview Notebook page
148 self
.ovr
= wxTextCtrl(self
.nb
, -1, style
= wxTE_MULTILINE|wxTE_READONLY
)
149 self
.nb
.AddPage(self
.ovr
, "Overview")
152 # Set up a TextCtrl on the Demo Code Notebook page
153 self
.txt
= wxTextCtrl(self
.nb
, -1,
154 style
= wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL
)
155 self
.txt
.SetFont(wxFont(9, wxMODERN
, wxNORMAL
, wxNORMAL
, false
))
156 self
.nb
.AddPage(self
.txt
, "Demo Code")
159 # Set up a log on the View Log Notebook page
160 self
.log
= wxTextCtrl(logParent
, -1,
161 style
= wxTE_MULTILINE|wxTE_READONLY|wxHSCROLL
)
162 (w
, self
.charHeight
) = self
.log
.GetTextExtent('X')
163 self
.WriteText('wxPython Demo Log:\n')
167 # add the windows to the splitter and split it.
169 if _useNestedSplitter
:
170 splitter2
.SplitHorizontally(self
.nb
, self
.log
)
171 splitter2
.SetSashPosition(360, true
)
172 splitter2
.SetMinimumPaneSize(20)
174 splitter
.SplitVertically(self
.tree
, splitter2
)
176 splitter
.SplitVertically(self
.tree
, self
.nb
)
178 splitter
.SetSashPosition(180, true
)
179 splitter
.SetMinimumPaneSize(20)
182 # make our log window be stdout
185 # select initial items
186 self
.nb
.SetSelection(0)
188 self
.tree
.SelectItem(root
)
190 if len(sys
.argv
) == 2:
192 selectedDemo
= self
.treeMap
[sys
.argv
[1]]
195 if selectedDemo
and _useSplitter
:
196 self
.tree
.SelectItem(selectedDemo
)
197 self
.tree
.EnsureVisible(selectedDemo
)
200 self
.WriteText('window handle: %s\n' % self
.GetHandle())
203 #---------------------------------------------
204 def WriteText(self
, text
):
205 self
.log
.WriteText(text
)
206 w
, h
= self
.log
.GetClientSizeTuple()
207 numLines
= h
/self
.charHeight
208 x
, y
= self
.log
.PositionToXY(self
.log
.GetLastPosition())
210 self
.log
.ShowPosition(self
.log
.XYToPosition(x
, y
-numLines
))
211 ##self.log.ShowPosition(self.log.GetLastPosition())
212 self
.log
.SetInsertionPointEnd()
214 def write(self
, txt
):
217 #---------------------------------------------
218 def OnItemExpanded(self
, event
):
219 item
= event
.GetItem()
220 self
.log
.WriteText("OnItemExpanded: %s\n" % self
.tree
.GetItemText(item
))
222 #---------------------------------------------
223 def OnItemCollapsed(self
, event
):
224 item
= event
.GetItem()
225 self
.log
.WriteText("OnItemCollapsed: %s\n" % self
.tree
.GetItemText(item
))
227 #---------------------------------------------
228 def OnSelChanged(self
, event
):
232 item
= event
.GetItem()
233 itemText
= self
.tree
.GetItemText(item
)
234 self
.RunDemo(itemText
)
237 #---------------------------------------------
238 def RunDemo(self
, itemText
):
239 if self
.nb
.GetPageCount() == 3:
240 if self
.nb
.GetSelection() == 2:
241 self
.nb
.SetSelection(0)
242 self
.nb
.DeletePage(2)
244 if itemText
== 'Overview':
245 self
.GetDemoFile('Main.py')
246 self
.SetOverview('Overview', overview
)
251 if os
.path
.exists(itemText
+ '.py'):
253 self
.GetDemoFile(itemText
+ '.py')
254 module
= __import__(itemText
, globals())
255 self
.SetOverview(itemText
, module
.overview
)
258 # in case runTest is modal, make sure things look right...
262 self
.window
= module
.runTest(self
, self
.nb
, self
)
264 self
.nb
.AddPage(self
.window
, 'Demo')
265 #self.nb.ResizeChildren()
266 self
.nb
.SetSelection(2)
267 #self.nb.ResizeChildren()
268 #if self.window.GetAutoLayout():
269 # self.window.Layout()
278 #---------------------------------------------
280 def GetDemoFile(self
, filename
):
282 #if not self.txt.LoadFile(filename):
283 # self.txt.WriteText("Cannot open %s file." % filename)
285 self
.txt
.SetValue(open(filename
).read())
287 self
.txt
.WriteText("Cannot open %s file." % filename
)
290 self
.txt
.SetInsertionPoint(0)
291 self
.txt
.ShowPosition(0)
293 #---------------------------------------------
294 def SetOverview(self
, name
, text
):
296 self
.ovr
.WriteText(text
)
297 self
.nb
.SetPageText(0, name
)
298 self
.ovr
.SetInsertionPoint(0)
299 self
.ovr
.ShowPosition(0)
301 #---------------------------------------------
303 def OnFileExit(self
, event
):
307 def OnHelpAbout(self
, event
):
308 #about = wxMessageDialog(self,
309 # "wxPython is a Python extension module that\n"
310 # "encapsulates the wxWindows GUI classes.\n\n"
311 # "This demo shows off some of the capabilities\n"
313 # " Developed by Robin Dunn",
314 # "About wxPython", wxOK)
315 from About
import MyAboutBox
316 about
= MyAboutBox(self
)
321 #---------------------------------------------
322 def OnCloseWindow(self
, event
):
328 #---------------------------------------------
329 def OnIdle(self
, event
):
331 self
.otherWin
.Raise()
332 self
.window
= self
.otherWin
335 #---------------------------------------------
336 def OnDemoMenu(self
, event
):
339 selectedDemo
= self
.treeMap
[self
.mainmenu
.GetLabel(event
.GetId())]
343 self
.tree
.SelectItem(selectedDemo
)
344 self
.tree
.EnsureVisible(selectedDemo
)
346 self
.RunDemo(self
.mainmenu
.GetLabel(event
.GetId()))
348 #---------------------------------------------------------------------------
349 #---------------------------------------------------------------------------
353 wxImage_AddHandler(wxJPEGHandler())
354 wxImage_AddHandler(wxPNGHandler())
355 wxImage_AddHandler(wxGIFHandler())
356 frame
= wxPythonDemo(NULL
, -1, "wxPython: (A Demonstration)")
358 self
.SetTopWindow(frame
)
361 #---------------------------------------------------------------------------
368 #---------------------------------------------------------------------------
376 Python is an interpreted, interactive, object-oriented programming language often compared to Tcl, Perl, Scheme, or Java.
378 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.
383 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.
385 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.
390 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.
392 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.
394 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.
396 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.
405 #----------------------------------------------------------------------------
406 #----------------------------------------------------------------------------
408 if __name__
== '__main__':
411 #----------------------------------------------------------------------------