1 CHANGES.txt for wxPython
3 ----------------------------------------------------------------------
7 Added EVT_HELP, EVT_HELP_RANGE, EVT_DETAILED_HELP,
8 EVT_DETAILED_HELP_RANGE, EVT_CONTEXT_MENU, wxHelpEvent,
9 wxContextMenuEvent, wxContextHelp, wxContextHelpButton, wxTipWindow,
10 and a demo to show them in action.
12 Deprecated PyShell and PyShellWindow, added a snapshot of PyCrust (see
13 http://sourceforge.net/projects/pycrust/. )
15 Added the new virtual list capabilities to wxListCtrl.
17 Added a wxSTC style editor from Riaan Booysen to the sample apps.
19 Added XRCed to the wxPython Tools directory, contributed by Roman
22 Added a new "constructor" to most of the window classes that calls the
23 default C++ contructor, (the one with no parameters) and also added the
24 coresponding Create(...) method. This allows you to do a 2-step
25 creation of windows which is sometimes required for doing things such
26 as setting extended style flags before the window is created, or for
27 passing the object to the XRC resource system to be created from the
28 resource. The name of the new "constructor" is the original name of
29 the class with a "Pre" in it. For example, wxPreWindow, wxPreFrame,
32 Updated to version 1.40 of Scintilla and updated wxStyledTextCtrl
33 accordingly. While doing this update I dropped the wxLB_SORT style
34 from the wxListBox created for the AutoComplete functionality. This
35 means that you will have to sort the keyword lists yourself, but you
36 are free to do case sensitive or case insensitive sorts and set the
37 wxSTC flag accordingly.
39 Updated wxColumnSorterMixin to also be able to place sort icons on the
40 column headers, and updated the wxListCtrl demo to show it off by
41 using wxColumnSorterMixin.
43 Added wxGenBitmapTextButton, TablePrint, etc. contribs from Lorne White.
45 Added wxNativeFontInfo and wxFontMapper.
47 Added pySketch to the samples.
49 Significantly changed how the Python interpreter lock and thread state
50 are managed, which should fix the problem of running on a
51 multi-processor machine.
53 Added wxPyLog so log targets can be created in Python to handle log
54 messages however is wished. See demo/Main.py for an example.
56 Added wxFindReplaceDialog.
58 The second phase of OOR is implemented (for wxEvtHandler and derived
59 classes at least.) This means that finctions and methods that return
60 an object derived from wxEvtHandler that was originally created in
61 Python, will return the original python object (if it still exists)
62 instead of letting SWIG wrap a new shadow object around the original
65 Added some optimization methods to wxDC: GetBoundingBox, DrawLineList,
68 Added a set of sophisticated Error Dialogs from Chris Fama.
70 Added wxRightTextCtrl from Josu Oyanguren to wxPython.lib for aligning
71 text in a wxTextCtrl to the right side.
77 Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user
78 code can get access to the edit control when it is created, (to push
79 on a custom event handler for example.)
81 Added wxTextAttr class and SetStyle, SetDefaultStyle and
82 GetDefaultStyle methods to wxTextCtrl.
84 Added ability to use xml resource files. Still need to add ability to
85 subclass wxXmlResourceHandler, etc...
87 Added wxGridAutoEditMixin to the mixins library package.
89 Made ColourSelect be derived from wxButton.
91 Fixed img2py to work correctly with Python 2.1.
93 Added enhanced wxVTKRenderWindow by Prabhu Ramachandran
99 Removed initial startup dependency on the OpenGL DLLs so only the
100 glcanvasc.pyd depends on them, (on wxMSW.)
102 Changed wxFont, wxPen, wxBrush to not implicitly use the
103 wxThe[Font|Pen|Brush]List objects behind the scenes, but to use normal
106 Exposed the wxThe[Font|Pen|Brush]List to wxPython.
108 Also added wxTheColourDatabase and added a library module (in the
109 wxPython.lib.colourdb module) to load LOTS more colour names into the
112 Added wxWakeUpMainThread, wxMutexGuiEnter, wxMutexGuiLeave,
113 wxMutexGuiLocker and wxThread_IsMain to assist with dealing with GUI
114 access from non-GUI threads.
116 wxPyOnDemandOutputWindow is now (more) thread safe if non-GUI threads
117 use print, sys.stdout.write, etc.
119 Added CreateTextSizer and CreateButtonSizer to wxDialog
121 Added wxPython/lib/infoframe.py from Chris Fama. It contains a class
122 that can be used in place of wxPyOnDemandOutputWindow.
124 Added colourselect.py, imagebrowser.py and an updated calendar.py to
125 wxPython/lib from Lorne White.
127 Added patch to wxPoint_LIST_helper from Tim Hochberg that should make
128 it gobs faster in certain situations.
130 Added tools that will take an image file in a wx supported format and
131 convert it to data embedded in a Python source file. The image is
132 converted to XPM format which is essentially a list of strings
133 containing info about each pixel. The image's transparency mask is
134 included, if there is one, or a mask can be added if a mask colour is
135 specified on the command line. It is then pickled and optionally
136 compressed and written to a Python source file along with functions to
137 convert it to either a wxBitmap or a wxImage. See
138 wxPython/demo/images.py for examples, and wxPython/Tools/img2py.py for
141 Fixed wxStyledTextCtrl to be much faster on wxGTK. There was some
142 experimental code that got left in place that ended up causing way too
145 A couple more hacks in my_distutils.py so wxPython can be built with
146 the distutils that comes with Python 2.1.
148 Added a ton of missing methods for wxPrintData.
150 Switched to InnoSetup for MSW distributions.
152 Added wxToggleButton.
154 Fixed bug that prevented wxTreeCtrl.OnCompareItems from being called.
156 Added some methods to wxGrid:
157 GetCellHighlightPenWidth
158 GetCellHighlightROPenWidth
159 SetCellHighlightPenWidth
160 SetCellHighlightROPenWidth
162 GetGridRowLabelWindow
163 GetGridColLabelWindow
164 GetGridCornerLabelWindow
166 Added wxGetClientDisplayRect which on wxMSW returns a wxRect
167 representing the area on screen not occupied by the taskbar and such.
168 On other platforms it is equivallent to wxGetDisplaySize.
171 ***---***---***---***---***---***---***---***---***---***---***---
172 Implemented the first phase of OOR (Original Object Return). See
173 the text in the demo for more details of what this means, but in a
174 nutshell methods such as wxWindow.GetParent or FindWindowById will
175 now return a shadow object of the proper type if it can. By
176 "proper type" I mean that if the wxWindow pointer returned from
177 FindWindowById really points to a wxButton then the Python object
178 constructed will be of a wxButtonPtr class instead of wxWindowPtr
179 as before. This should reduce or eliminiate the need for
180 wxPyTypeCast. (Woo Hoo!) The objects returned are still not the
181 original Python object, but that is the next step. (Although it
182 will probably only work on Python 2.1 and beyond because it will
183 use weak references.)
185 This first phase of the OOR plan is fairly significant and has
186 required a lot of changes all over wxPython, most of which should
187 be transparent to you, however I'm not 100% sure that it didn't
188 introduce any new bugs that are hiding somewhere and didn't get
189 stomped on during my testing. So please be sure to test everything
190 thoroughly when you install this version and be sure to report any
191 object-type related oddities to me.
192 ***---***---***---***---***---***---***---***---***---***---***---
194 There is now a wxObject class that most other classes derive from like
195 in C++, but the methods provided don't really match but are wxPython
196 specific. It could have been added long ago but OOR required it so it
199 Finally added wxPyLineShape.GetLineControlPoints, which has been on my
200 list for a while. The above OOR modification made this easier.
202 Fixed the __cmp__ methods for wxPoint and others.
206 Added the wxPython.lib.mixins package to the library, it is where
207 useful mix-in classes can be placed. Currently there is one to help
208 make the columns in a wxListCtrl sortable, and the MagicIMageList from
209 Mike Fletcher. If you have any custom code that can be factored out
210 of existing classes into a mix-in that would be useful to others
211 please send it to me for inclusion in this package.
213 Added a few little sample applications to help newbies to get started
214 by having smaller functional apps to play with. They can be found in
223 No changes happened in the Python wrappers for this release, only
224 changes and fixes in the wxWindows library.
231 New typemaps for wxString when compiling for Python 2.0 and beyond
232 that allow Unicode objects to be passed as well as String objects. If
233 a Unicode object is passed PyString_AsStringAndSize is used to convert
234 it to a wxString using the default encoding.
236 Fixed the generic buttons so tool tips work for them.
238 Fixed a bug in the demo's tree control.
240 Added a listbox to the listbox demo that shows how to find items with
241 a matching prefix as keys are typed.
243 Added code to the wxListCtrl demo to show how to get text from a
244 column in report mode.
246 Added code to the toolbar demo to clear the long help from the status
251 Fixed wxTimer so it can be used as described in the docs, either with
252 a Notify method in a subclass, or sending an event to a wxEvtHandler
253 object, (usually a window.)
255 Added wxNotifyEvent.Allow()
257 Fixed GOBS of reference leaks.
259 Massive code changes and cleanup to allow wxPython to be split into
260 multiple extension modules again. A Python CObject is used to allow
261 the "export" of SWIG functions and other common helper functions from
262 the wxc module to other modules, even if they are in separate shared
263 libraries. Should also be usable from 3rd party code, just include
264 wxPython/src/export.h
266 Changed the default setup so the following are built as separate
267 extension modules: calendar, glcanvas, grid, html, ogl, stc, and
268 utils. Will probably add more later.
270 Changed the wxPrinterDC to use the new constructor taking a
271 wxPrintData object. The old ctor is still there using the
274 Added wxPython.lib.anchors.py from Riaan Booysen. It contains a class
275 that implements Delphi's Anchors with wxLayoutConstraints.
277 Added wxPython.lib.fancytext from Timothy Hochberg.
279 Changed the GenericButtons to send their event in idle time, so the
280 mouse won't be captured when the event handler is called.
282 Added wxPython.lib.rpcMixin from Greg Landrum, although it's not
283 integrated with the demo yet. It allows a wxPython GUI to be an
291 Significantly changed how the wxStyledtextCtrl code that wraps
292 Scintilla is implemented. Most of it is now automatically generated
293 from an interface definition file provided by Scintilla. This means
294 that it will be much easier to stay in sync with new Scintilla
295 releases, but also means that some of the method and identifier names
296 have changed. See wxPython/demo/data/stc.h for a copy of the C++
297 interface from which the Python interface is generated. There is now
298 some inline documentation in that file that should really help explain
301 I am now using the Python Distutils to build wxPython and to make some
302 of the distribution files. (See http://www.python.org/sigs/distutils-sig/)
303 This means no more messing with my kludgy build.py/Makefile hack,
304 builds will be more consistent with other Python extensions that also
305 use Distutils, and will hopefully make wxPython easier to build for
306 platforms where there have been troubles before. If you are building
307 wxPython for Python 1.5.2 or for 1.6, then you will need to get and
308 install version 1.0 of Distutils from the website above. If you are
309 using Python 2.0 then you already have it.
311 Added wxInputStream and the wxFileSystem family of classes,
312 contributed by Joerg Baumann.
314 Added wxProcess and support for it to wxExecute. wxProcess lets you
315 get notified when an asyncronous child process terminates, and also to
316 get input/output streams for the child process's stdout, stderr and
319 Removed the old python sizers.
321 Added __add__, __sub__ and __cmp__ (equality check only) for wxPoint
324 Changed the build to make one big extension module instead of one for
325 the core and each contrib. This allowed me to do away with the
326 libwxPyHelpers.so on unix systems.
328 Lots of little fixes here and there.
330 Some hacks on wxGTK to try and make the AutoComplete listbox in the
331 wxStyledTextCtrl to behave better. It's still not as nice as on
332 wxMSW, but at least it's a bit more usable now.
340 Various tweaks, fixes, missing methods, etc.
342 Added example use of wxTaskBarIcon to the demo.
349 Added wxLog and friends.
351 Added wxFrame.ShowFullScreen for MSW.
353 Added PyShellWindow to the wxPython.lib package.
360 Added an attribute named labelDelta to the generic buttons that
361 specifies how far to offset the label when the button is in the
364 Added wxTipProvider and friends. See the demo for an example.
366 wxGrid can now change the cell highlight colour.
370 Fixed printing on wxGTK.
372 Added wxDateTime, wxTimeSpan, and wxDateSpan to wxPython.utils.
374 Added wxCalendarCtrl.
376 WARNING: A while back I asked what should be done about the Magic
377 Method Names. (Methods that are automatically turned into event
378 handlers by virtue of their name.) The consensus was that it is more
379 confusing to have them than to try and expand them to have greater
380 coverage. I am finally getting around to removing the code that
381 generates the event binding. This means that if you are using any of
382 the following method names without a EVT_* call that you need to
383 modify your code to add the EVT_* to hook the event to the method.
405 Fixed wxTreeCtrl.HitTest to return both the tree item as well as the
406 flags that clairify where the click was in relation to the item.
408 Fixed thread state problem in wxTreeCtrl.GetBoundingBox and
411 Fixed some problems in OGL. Also wxShape.SetClientData and
412 .GetClientData can now deal with Python objects.
414 Added wxListCtrl.SortItems and changed the demo to show how to use it.
416 Plugged a memory leak.
418 Wrapped the new wxGrid and friends. The old wxGrid class is no longer
419 available. There are some incompatibilities, and unfortunately the
420 new classes are not documented yet, (however the methods are more
421 consistent with each other now so you may be able to guess pretty
424 Updated filebrowsebutton.py and calendar.py with changes from their
425 authors. There is now a FileBrowseButtonWithHistory class (what a
426 mouthful!) and wxCalendar has printing support.
428 Added ActiveXWrapper to the library, and some good demos of it too.
429 It works great for embedding a COM (a.k.a OCX, a.k.a ActiveX) control
430 in a window and calling its methods. It actually creates a new class
431 on the fly that derives from wxWindow, the COM CoClass and others
432 needed to make it all work. The resulting class can be instantiated
433 just like wxWindow, used in sizers, etc. It also responds to all COM
434 method calls, properties, etc., and if the class or a mix-in has
435 matching method names, then the COM events will be propogated back to
438 Created a typemap that allows a string to be used for parameters
439 expecting a wxColour type. The string is either a colour name as
440 defined in the wxColourDatabase, or a colour spec of the form
441 "#RRGGBB". See the wxStyledTextCtrl demo for an example.
443 I almost forgot to mention the wxStyledTextCtrl! Yes, the
444 wxStyledTextCtrl is finally in wxPython!! (And the crowd goes
445 wild...) There's no documentaTion yet (the crowd boos and hisses...)
446 but I've included a very readable source file in the
447 wxPython/demo/data directory, a couple fairly good examples, and you
448 can also refer to the Scintilla documentaion at
449 http://www.scintilla.org/ScintillaDoc.html to help fill in the gaps
450 until the docs are done. (The croud murmers contentedly as the tool
451 provider smiles convincingly and removes his flame-proof suit.)
458 Skipped a version number to match what has been released for wxGTK.
460 Updated wxMVCTree and added a demo for it, also fixed layout on GTK
461 and some flicker problems.
463 Added a wrapper class for the Visualization ToolKit (or VTK) in the
464 wxPython.lib.vtk module. (http://www.kitware.com/)
466 Fixed wxTreeCtrl.SetItemImage and GetItemImage to recognise the new
469 Added wxPython.lib.spashscreen from Mike Fletcher.
471 Added wxPython.lib.filebrowsebutton also from Mike Fletcher.
473 Renamed wxTreeCtrl.GetParent to GetItemParent to avoid a name clash
474 with wxWindow.GetParent.
476 Added wxIntersectRect to compute the intersection of two wxRect's.
477 It is used like this:
479 intersect = wxIntersectRect(rect1, rect2)
481 If r1 and r2 don't intersect then None is returned, otherwise the
482 rectangle representing the intersection is returned.
484 Some bug fixes for Clipboard and Drag-n-Drop.
486 Rotated text!!! WooHoo! (See wxDC.DrawRotatedText())
488 Added a set of Generic Buttons to the library. These are simple
489 window classes that look and act like native buttons, but you can have
490 a bit more control over them. The bezel width can be set in addition
491 to colours, fonts, etc. There is a ToggleButton as well as Bitmap
492 versions too. They should also serve as a good example of how to
493 create your own classes derived from wxControl.
495 The C++ wxToolBar classes have been redone, and so have the wxPython
496 wrappers. There have been slight modifications to some of the methods
497 but shouldn't impact anybody too much. I took the opportunity to add
498 support for setting user data on each toolbar tool. The new AddTool
499 methods look like this:
503 pushedBitmap = wxNullBitmap,
506 shortHelpString = "",
509 def AddSimpleTool(ID,
511 shortHelpString = "",
516 There are also coresponding InsertTool and InsertSimpleTool methods
517 that additionally take an integer position as the first parameter.
519 Added a wrapper for the new PCX and TIFF ImageHandlers.
521 wxRect now simulates attributes named left, right, top and bottom.
523 Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
524 is better and compatible with the wxGLCanvas. You can get it at
525 http://starship.python.net:9673/crew/da/Code/PyOpenGL.
527 Added some missing EVT_ functions.
529 Added Dirk Holtwic's editor classes to the wxPython.lib.editor
532 Changed all the "LIST" parameter names to "choices" to match the docs.
534 More fixes for the wxFloatBar, and it now works on wxGTK even better
535 than wxMSW! (The feat is accomplished by using the wxTB_DOCKABLE
536 style flag instead of trying to float it ourselves.)
543 Skipped a few version numbers so wxMSW, wxGTK and wxPython are all
546 wxImage.SetData now makes a copy of the image data before giving it to
547 wxImage. I mistakenly thought that wxImage would copy the data
550 Fixed wxMSW's notebook so the pages get their size set as they are
551 being added. This should remove the need for our
552 wxNotebook.ResizeChildren hack.
554 wxPanels now support AutoLayout, and wxNotebooks and wxSplitterWindows
555 no longer tell their children to Layout() themselves. This will
556 probably only effect you if you have a wxWindow with AutoLayout inside
557 a notebook or splitter. If so, either change it to a wxPanel or add
558 an EVT_SIZE handler that calls Layout().
560 Fixed deadlock problem that happened when using threads.
562 Added new HTML printing classes.
564 Added wxWindow.GetHandle
566 Apparently wxMouseEvent.Position has been depreciated in wxWindows as
567 it is no longer available by default. You can use GetPositionTuple
568 (returning a tuple with x,y) instead, or GetPosition (returning a
571 Added wxPostEvent function that allows events to be posted and then
572 processed later. This is a thread-safe way to interact with the GUI
573 thread from other threads.
575 Added Clipboard and Drag-and-Drop classes.
577 Added wxFontEnumerator.
579 Many updates to wxMenu, wxMenuBar.
581 wxPyEvent and wxPyCommandEvent derived classes now give you the actual
582 Python object in the event handler instead of a new shadow.
584 Added a Calendar widget from Lorne White to the library.
586 Made some fixes to the wxFloatbar. It still has some troubles on
589 Added an MVC tree control from Bryn Keller to the library.
596 This is a quick bug-fix release to take care of a few nasties that
597 crept in at the last minute before 2.1.4 was called done. No new
605 This release is NOT syncronized with a snapshot release of wxGTK or
606 wxMSW. For MSW this isn't much of a problem since you can get the
607 binaries from the web site. For other platforms you'll have to build
608 wxGTK from CVS. (See http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm)
609 To get the same set of sources from CVS that I used, checkout using
612 Now back to what's new...
614 Much more support for event-less callbacks and add-on modules.
616 Created add-on module with wxOGL classes.
618 Added wxWindow.GetChildren(). Be careful of this. It returns a *copy*
619 of the list of the window's children. While you are using the list if
620 anything changes in the real list (a child is deleted, etc.) then the
621 list you are holding will suddenly have window references to garbage
622 memory and your app will likely crash. But if you are careful it works
625 Added a bunch of new and missing methods to wxTreeCrtl. The
626 SortChildren method is now supported, but currently only for the
629 Added typemaps for wxSize, wxPoint, wxRealPoint, and wxRect that allow
630 either the actual objects or Python sequence values to be used. For
631 example, the following are equivallent:
633 win = wxWindow(parent, size = wxSize(100, 100))
634 win = wxWindow(parent, size = (100, 100))
636 Super-charged the wxHtml module. You can now create your own tag
637 handlers and also have access to the parser and cell classes. There
638 is a tag handler in the library at wxPython.lib.wxpTag that
639 understands the WXP tag and is able to place wxPython windows on HTML
640 pages. See the demo for an example.
642 A bunch of the methods of wxMenuBar were previously ifdef'd out for
643 wxGTK. Added them back in since the methods exist now.
645 Wrapped the wxHtmlHelpController and related classes.
647 Wrapped the C++ versions of wxSizer and friends. The Python-only
648 versions are still in the library, but depreciated. (You will get a
649 warning message if you try to use them, but the warning can be
650 disabled.) The usage of the C++ versions is slightly different, and
651 the functionality of wxBorderSizer is now part of wxBoxSizer. I have
652 added a few methods to wxSizer to try and make the transition as
653 smooth as possible, I combined all Add methods into a single method
654 that handles all cases, added an AddMany method, etc. One step I did
655 not take was to make the default value of flag in the Add method be
656 wxGROW. This would have made it more backward compatible, but less
657 portable to and from wxWin C++ code. Please see the docs and demo for
660 Added wxPyEvent and wxPyCommandEvent classes, derived from wxEvent and
661 wxCommandEvent. Each of them has SetPyData and GetPyData methods that
662 accept or return a single Python object. You can use these classes
663 directly or derive from them to create your own types of event objects
664 that can pass through the wxWindows event system without loosing their
665 Python parts (as long as they are stored with SetPyData.) Stay tuned
666 for more info and examples in future releases.
668 Added wxPython.lib.grids as an example of how to derive a new sizer
669 from the C++ sizers. In this module you will find wxGridSizer and
670 wxFlexGridSizer. wxGridSizer arrainges its items in a grid in which
671 all the widths and heights are the same. wxFlexgridSizer allows
672 different widths and heights, and you can also specify rows and/or
673 columns that are growable. See the demo for a couple examples for how
676 Added the wxValidator class, and created a class named wxPyValidator
677 that should be used for the base class of any Python validators. See
678 the demo for an example. Please note that you MUST implement a Clone
679 method in your validator classes because of the way some things work
680 in the underlying C++ library. I did not add wxTextValidator because
681 of some issues of how it transfers data to and from a wxString, which
682 in wxPython is automatically translated to and from Python strings, so
683 there would never be a concrete wxString that would hang around long
684 enough for the validator to do its job. On the other hand, it should
685 be real easy to duplicate the functionality of wxTextValidator in a
686 pure Python class derived from wxPyValidator.
688 I've finally added a feature that has been on my list for close to two
689 years! Ever wondered what that zero is for when you create your app
690 object? Well now you can leave it out or explicitly set it to a true
691 value. This value now controls what is to be done with sys.stdout and
692 sys.stderr. A false value leaves them alone, and a true value sets
693 them to an instance of wxPyOnDemandOutputWindow. (On windows the
694 default is true, on unix platforms the default is false.) This class
695 creates a frame containing a wxTextCtrl as soon as anything is written
696 to sys.stdout or sys.stderr. If you close the window it will come
697 back again the next time something is written. (You can call
698 app.RestoreStdio to turn this off.) If you would rather that the stdio be
699 redirected to a file, you can provide a second parameter to your app
700 object's constructor that is a filename. If you want to use your own
701 class instead of wxPyOnDemandOutputWindow you can either implement
702 RedirectStdio() in you app class or change the value of
703 wxApp.outputWindowClass like this:
706 outputWindowClass = MyClass
710 self.SetTopWindow(frame)
713 Please see the implementation of wxPyOnDemandOutputWindow and wxApp in
714 wx.py for more details. A few words of caution: if you are running
715 your app in a debugger, changing sys.stdout and sys.stderr is likely
716 to really screw things up.
718 Added wxCaret. Unfortunately it's author has still not documented it
719 in the wxWindows docs...
721 Some new 3rd party contributions in wxPython.lib. PyShell, in
722 shell.py is an interesting implementaion of an interactive Python
723 shell in wxWindows. floatbar.py has a class derived from wxToolBar
724 that can sense mouse drags and then reparent itself into another
725 frame. Moving the new frame close to where it came from puts the tool
726 bar back into the original parent. (Unfortunately there is currently
727 a bug in wxGTK's wxFrame.SetToolBar so the FloatBar has some
736 This release is syncronized with release 2.1 snapshot 9 of wxWindows.
738 Switched to using SWIG from CVS (see http://swig.cs.uchicago.edu/cvs.html)
739 for some of the new features and such. Also they have encorporated my
740 patches so there is really no reason to stick with the current (very
741 old) release... This version of SWIG gives the following new
744 1. Keyword arguments. You no longer have to specify all the
745 parameters with defaults to a method just to specify a
746 non-default value on the end. You can now do this instead:
748 win = wxWindow(parent, -1, style = mystyle)
750 2. There is now an an equivalence between Python's None and C++'s
751 NULL. This means that any methods that might return NULL will
752 now return None and you can use none where wxWindows might be
753 expecting NULL. This makes things much more snake-ish.
756 There is a new build system based on a new Python program instead of
757 raw makefiles. Now wxPython builds are virtually the same on MSW or
758 Unix systems. See the end of this file for new build instructions and
759 see distrib/build.py for more details.
761 wxDC.Bilt now includes the useMask parameter, and has been split into
762 two different versions. wxDC.BlitXY is like what was there before and
763 takes raw coordinants and sizes, and the new wxDC.Blit is for the new
764 interface using wxPoints and a wxSize.
773 Added the missing wxWindow.GetUpdateRegion() method.
775 Made a new change in SWIG (update your patches everybody) that
776 provides a fix for global shadow objects that get an exception in
777 their __del__ when their extension module has already been deleted.
778 It was only a 1 line change in .../SWIG/Modules/pycpp.cxx at about
779 line 496 if you want to do it by hand.
781 It is now possible to run through MainLoop more than once in any one
782 process. The cleanup that used to happen as MainLoop completed (and
783 prevented it from running again) has been delayed until the wxc module
784 is being unloaded by Python.
786 I fixed a bunch of stuff in the C++ version of wxGrid so it wouldn't
787 make wxPython look bad.
789 wxWindow.PopupMenu() now takes a wxPoint instead of x,y. Added
790 wxWindow.PopupMenuXY to be consistent with some other methods.
792 Added wxGrid.SetEditInPlace and wxGrid.GetEditInPlace.
794 You can now provide your own app.MainLoop method. See
795 wxPython/demo/demoMainLoop.py for an example and some explaination.
797 Got the in-place-edit for the wxTreeCtrl fixed and added some demo
798 code to show how to use it.
800 Put the wxIcon constructor back in for GTK as it now has one that
803 Added wxGrid.GetCells
805 Added wxSystemSettings static methods as functions with names like
806 wxSystemSettings_GetSystemColour.
808 Removed wxPyMenu since using menu callbacks have been depreciated in
809 wxWindows. Use wxMenu and events instead.
811 Added alternate wxBitmap constructor (for MSW only) as
812 wxBitmapFromData(data, type, width, height, depth = 1)
814 Added a helper function named wxPyTypeCast that can convert shadow
815 objects of one type into shadow objects of another type. (Like doing
816 a down-cast.) See the implementation in wx.py for some docs.
818 Fixed wxImage GetData and SetData to properly use String objects for
821 Added access methods to wxGridEvent.
823 New Makefile/Setup files supporting multiple dynamic extension modules
826 Fixes for the wxGLCanvas demo to work around a strange bug in gtk.
828 SWIG support routines now compiled separately instead of being bundled
837 Fixed wxComboBox.SetSelection so that it actually sets the selected
838 item. (Actually just removed it from wxPython and let it default to
839 wxChoice.SetSelection which was already doing the right thing.)
841 Added the Printing Framework.
843 Switched back to using the wxWindows DLL for the pre-built Win32
844 version. The problem was needing to reinitialize static class info
845 data after loading each extension module.
847 Lots of little tweaks and additions to reflect changes to various
850 Fixed a bug with attaching objects to tree items. Actually was a
851 symptom of a larger problem with not obtaining the interpreter lock
852 when doing any Py_DECREFs.
854 wxSizer and friends. Sizers are layout tools that manage a colection
855 of windows and sizers. Different types of sizers apply different
856 types of layout algorithms. You saw it here first! These classes are
857 not even in the wxWindows C++ library yet!
863 Bug fix for ListCtrl in test4.py (Was a missing file... DSM!)
865 Bug fix for occassional GPF on Win32 systems upon termination of a
866 wxPython application.
868 Added wxListBox.GetSelections returning selections as a Tuple.
870 Added a wxTreeItemData that is able to hold any Python object and be
871 associated with items in a wxTreeCtrl. Added test pytree.py to show
874 Added wxSafeYield function.
876 OpenGL Canvas can be optionally compiled in to wxPython.
878 Awesome new Demo Framework for showing off wxPython and for learning
881 The pre-built Win32 version is no longer distributing the wxWindows
882 DLL. It is statically linked with the wxWindows library instead.
884 Added a couple missing items from the docs.
886 Added wxImage, wxImageHandler, wxPNGHandler, wxJPEGHandler,
887 wxGIFHandler and wxBMPHandler.
889 Added new methods to wxTextCtrl.
891 Fixed some problems with how SWIG was wrapping some wxTreeCtrl
898 Support for using Python threads in wxPython apps.
900 Several missing methods from various classes.
908 Added DLG_PNT and DLG_SZE convienience methods to wxWindow class.
910 Added missing constructor and other methods for wxMenuItem.
916 Just a quickie update to fix the self-installer to be compatible with
917 Python 1.5.2b2's Registry settings.
922 Well obviously the numbering scheme has changed. I did this to
923 reflect the fact that this truly is the second major revision of
924 wxPython, (well the third actually if you count the one I did for
925 wxWindows 1.68 and then threw away...) and also that it is associated
926 with the 2.0 version of wxWindows.
928 I have finally started documenting wxPython. There are several pages
929 in the wxWindows documentation tree specifically about wxPython, and I
930 have added notes within the class references about where and how wxPython
931 diverges from wxWindows.
933 Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
934 window handle. If you can get the window handle into the python code,
935 it should just work... More news on this later.
937 Added wxImageList, wxToolTip.
939 Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
942 As usual, some bug fixes, tweaks, etc.
948 Added wxSashWindow, wxSashEvent, wxLayoutAlgorithm, etc.
950 Various cleanup, tweaks, minor additions, etc. to maintain
951 compatibility with the current wxWindows.
957 Changed the import semantics from "from wxPython import *" to "from
958 wxPython.wx import *" This is for people who are worried about
959 namespace pollution, they can use "from wxPython import wx" and then
960 prefix all the wxPython identifiers with "wx."
962 Added wxTaskbarIcon for wxMSW.
964 Made the events work for wxGrid.
968 Added wxMiniFrame for wxGTK.
970 Changed many of the args and return values that were pointers to gdi
971 objects to references to reflect changes in the wxWindows API.
973 Other assorted fixes and additions.
981 wxPython on wxGTK works!!! Both dynamic and static on Linux and
982 static on Solaris have been tested. Many thanks go to Harm
983 <H.v.d.Heijden@phys.tue.nl> for his astute detective work on tracking
984 down a nasty DECREF bug. Okay so I have to confess that it was just a
985 DSM (Dumb Stupid Mistake) on my part but it was nasty none the less
986 because the behavior was so different on different platforms.
988 The dynamicly loaded module on Solaris is still segfaulting, so it
989 must have been a different issue all along...
996 1. Worked on wxGTK compatibility. It is partially working. On a
997 Solaris/Sparc box wxPython is working but only when it is statically
998 linked with the Python interpreter. When built as a dyamically loaded
999 extension module, things start acting weirdly and it soon seg-faults.
1000 And on Linux both the statically linked and the dynamically linked
1001 version segfault shortly after starting up.
1003 2. Added Toolbar, StatusBar and SplitterWindow classes.
1005 3. Varioius bug fixes, enhancements, etc.
1007 ----------------------------------------------------------------------