]> git.saurik.com Git - wxWidgets.git/blame - wxPython/CHANGES.txt
Probably only whitespace changes
[wxWidgets.git] / wxPython / CHANGES.txt
CommitLineData
6d75ea8f
RD
1CHANGES.txt for wxPython
2
3----------------------------------------------------------------------
4
b5a5d647
RD
52.3.3
6-----
b5a5d647
RD
7Added wxSplashScreen.
8
68320e40
RD
9Added wxGenericDirCtrl.
10
ce914f73 11Added wxMultiChoiceDialog.
68320e40 12
769a9cb2
RD
13The calltip window and autocomplete window in wxSTC will now use a
14wxPopupWindow if available so they can extend beyond the client area
15of the STC if needed.
16
f74ff5ef
RD
17Finished wrapping and providing typemaps for wxInputStream and also
18added the stream ctor and other methods for wxImage so images can now
19be loaded from any Python "file-like" object.
20
afb810d9
RD
21Changed the img2py tool to use PNG instead of XPM for embedding image
22data in Python source code, and the generated code now uses streams to
23convert the image data to wxImage, wxBitmap, or wxIcon.
f74ff5ef 24
68bc8549
RD
25Added the wxPython.lib.rcsizer module which contains RowColSizer.
26This sizer is based on code from Niki Spahiev and lets you specify a
27row and column for each item, as well as optional column or row
28spanning. Cells with no item assigned to it are just left blank.
29Stretchable rows or columns are specified and work the same as in
30wxFlexGridSizer.
96de41c2 31
18fc9fa3
RD
32Updated XRCed from Roman Rolinsky
33
e9159fe8
RD
34Added wxBufferedDC.
35
1a2fb4cd
RD
36Upgraded wxSTC from Scintilla 1.40 to Scintilla 1.45
37
b96c7a38
RD
38UNICODE!
39
40 wxWindows/wxPython can be compiled with unicode support enabled or
41 disabled. Previous to wxPython 2.3.3 non-unicode mode was always
42 used. Starting with 2.3.3 either mode is supported, but only if
36d91193 43 it is also available in wxWindows on the platform. Currently
b96c7a38
RD
44 wxWindows only supports unicode on MS Windows platforms, but with
45 the recent release of GTK+ 2.0 it is only a matter of time until
46 it can be done on wxGTK (Linux and other unixes) as well.
47
48 Unicode works best on platforms in the NT branch of the Windows
49 family tree (NT, win2k, XP) but it is now also possible to use the
50 same unicode binaries on win95/98/ME platforms as well! This is
36d91193
RD
51 done by using a special library and DLL with the application
52 called MSLU, (Microsoft Layer for Unicode). It simply gets out of
53 the way if the app is run on an NT box, otherwise if run on a
54 win9x box it loads a special DLL that provides the unicode
55 versions of the windows API. So far I have not been able to get
56 this to work perfectly on win9x. Most things work fine but
57 wxTaskBarIcon for example will cause a crash if used with the
58 unicode build on win95.
b96c7a38
RD
59
60 So how do you use it? It's very simple. When unicode is enabled,
61 then all functions and methods in wxPython that return a wxString
62 from the C++ function will return a Python unicode object, and
63 parameters to C++ functions/methods that expect a wxString can
64 accept either a Python string or unicode object. If a string
65 object is passed then it will be decoded into unicode using the
66 converter pointed to by wxConvCurrent, which will use the default
67 system encoding. If you need to use a string in some other
68 encoding then you should convert it to unicode using the Python
69 codecs first and then pass the unicode string to the wxPython
70 method.
71
726fc00a 72Added wxListCtrlAutoWidthMixin from Erik Westra.
b96c7a38 73
0e9b78ce
RD
74Added wxIconBundle and wxTopLevelWindow.SetIcons.
75
68bc8549
RD
76Added wxLocale and wxEncodingConverter.
77
c8b34a16
RD
78A little black magic... When the C++ object (for a window or
79whatever) is deleted there is no way to force the Python shadow object
80to also be destroyed and clean up all references to it. This leads to
81crashes if the shadow object tries to call a method with the old C++
82pointer. The black magic I've done is to replace the __class__ in the
83Python instance object with a class that raises an exception whenever
84a method call (or other attribute access) is attempted. This works
85for any class that is OOR aware.
0e9b78ce 86
33ff77f6
RD
87Added OOR support for wxGridCellRenderer, wxGridCellEditor,
88wxGridCellAttr, wxGridCellAttrProvider, wxGridTableBase and their
2d956b58 89derived classes.
33ff77f6 90
d55d6b3f
RD
91Added wxImage.GetDataBuffer which returns an in-place edit buffer of
92the image data. (Patch #546009)
33ff77f6 93
b5a5d647
RD
94
95
3bd1e033 96
4268f798 972.3.2.1
71f1334b 98-------
4268f798
RD
99Changed (again) how the Python global interpreter lock is handled as
100well as the Python thread state. This time it works on SMP machines
101without barfing and is also still compatible with Python debuggers.
102
103Added some patches from library contributors.
104
105
106
ebf4302c 1072.3.2
4f3449b4
RD
108-----
109Added EVT_HELP, EVT_HELP_RANGE, EVT_DETAILED_HELP,
110EVT_DETAILED_HELP_RANGE, EVT_CONTEXT_MENU, wxHelpEvent,
111wxContextMenuEvent, wxContextHelp, wxContextHelpButton, wxTipWindow,
112and a demo to show them in action.
113
fea018f8
RD
114Deprecated PyShell and PyShellWindow, added a snapshot of PyCrust (see
115http://sourceforge.net/projects/pycrust/. )
4f3449b4 116
c7e7022c 117Added the new virtual list capabilities to wxListCtrl.
4f3449b4 118
00b6c4e3 119Added a wxSTC style editor from Riaan Booysen to the sample apps.
4f3449b4 120
09f3d4e6
RD
121Added XRCed to the wxPython Tools directory, contributed by Roman
122Rolinsky.
123
124Added a new "constructor" to most of the window classes that calls the
6d19860f 125default C++ contructor, (the one with no parameters) and also added the
09f3d4e6
RD
126coresponding Create(...) method. This allows you to do a 2-step
127creation of windows which is sometimes required for doing things such
128as setting extended style flags before the window is created, or for
129passing the object to the XRC resource system to be created from the
130resource. The name of the new "constructor" is the original name of
131the class with a "Pre" in it. For example, wxPreWindow, wxPreFrame,
132etc.
133
fe0aca37 134Updated to version 1.40 of Scintilla and updated wxStyledTextCtrl
a6978454
RD
135accordingly. While doing this update I dropped the wxLB_SORT style
136from the wxListBox created for the AutoComplete functionality. This
137means that you will have to sort the keyword lists yourself, but you
138are free to do case sensitive or case insensitive sorts and set the
139wxSTC flag accordingly.
4f3449b4 140
6d19860f
RD
141Updated wxColumnSorterMixin to also be able to place sort icons on the
142column headers, and updated the wxListCtrl demo to show it off by
143using wxColumnSorterMixin.
144
53fe40ba 145Added wxGenBitmapTextButton, TablePrint, etc. contribs from Lorne White.
ddcb3d83 146
6d8b4f8d 147Added wxNativeFontInfo and wxFontMapper.
4f3449b4 148
431f4c16 149Added pySketch to the samples.
4f3449b4 150
19a97bd6
RD
151Significantly changed how the Python interpreter lock and thread state
152are managed, which should fix the problem of running on a
153multi-processor machine.
154
76bfdc78
RD
155Added wxPyLog so log targets can be created in Python to handle log
156messages however is wished. See demo/Main.py for an example.
157
0122b7e3
RD
158Added wxFindReplaceDialog.
159
71f1334b
RD
160The second phase of OOR is implemented for wxEvtHandler, wxSizer,
161wxShape and derived classes. This means that functions and methods
162that return an object derived from wxEvtHandler that was originally
163created in Python, will return the original Python object (if it still
164exists) instead of letting SWIG wrap a new shadow object around the
165original C++ pointer.
76bfdc78 166
9d37f964
RD
167Added some optimization methods to wxDC: GetBoundingBox, DrawLineList,
168DrawPointList.
169
79f1bf32
RD
170Added a set of sophisticated Error Dialogs from Chris Fama.
171
729f4276
RD
172Added wxRightTextCtrl from Josu Oyanguren to wxPython.lib for aligning
173text in a wxTextCtrl to the right side.
76bfdc78 174
71f1334b 175Added wxURLDataObject and an example showing drag and drop of URLs to
b37c7e1d
RD
176and from web browsers. It's still not 100% bullet-proof for all types
177of browsers, but it works for the majority of cases with the popular
178browsers on Windows. On wxGTK it seems that only Netscape 4.x works,
179if anybody has any suggestions about this please bring it up on the
180wx-dev list.
181
182Added wxStopWatch.
183
184Added wxMimeTypesManager and wxFileType.
185
c0c84fa0
RD
186Passing None for the handler parameter to one of the EVT_** functions
187will now Disconnect the event.
188
189Added wxPopupWindow and wxPopupTransientWindow.
190
7dbce44a
RD
191Added wxFileHistory.
192
71f1334b 193Added wxDynamicSashWindow, which allows you to endlessly split windows
ebf4302c 194by dragging a little tab next to the scrollbars. Added a demo to show
71f1334b 195this and also the ability of multiple wxStyledTextCtrls to share the
ebf4302c
RD
196same document.
197
611dc22c
RD
198Added wxEditableListBox gizmo.
199
78e8819c
RD
200Updated wxEditor with lots of enhancements from Steve Howell and Adam
201Feuer.
202
203Added the "SplitTree gizmos" which are a collection of classes that
204were designed to operate together and provide a tree control with
205additional columns for each item. The classes are
206wxRemotelyScrolledTreeCtrl, wxTreeCompanionWindow,
207wxThinSplitterWindow, and wxSplitterScrolledWindow, some of which may
208also be useful by themselves.
1918b6f7 209
4a61305d
RD
210Added wxDllWidget from Vaclav Slavik which allows wx widgets derived
211from wxWindow to be loaded from a C++ .dll (or .so) and be used in a
212wxPython program, without the widget having to be SWIGged first. The
213visible API of the widget is limited to wxWindow methods plus a
214SendCommand method, but it is still quite powerful. See
215wxPython/contrib/dllwidget and wxPython/demo/dllwidget for more
216details.
217
b37c7e1d 218
fea018f8
RD
219
220
286e2db6 2212.3.1
bf7945ce
RD
222-----
223Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user
224code can get access to the edit control when it is created, (to push
225on a custom event handler for example.)
226
d56cebe7
RD
227Added wxTextAttr class and SetStyle, SetDefaultStyle and
228GetDefaultStyle methods to wxTextCtrl.
229
230Added ability to use xml resource files. Still need to add ability to
231subclass wxXmlResourceHandler, etc...
232
233Added wxGridAutoEditMixin to the mixins library package.
234
235Made ColourSelect be derived from wxButton.
236
286e2db6
RD
237Fixed img2py to work correctly with Python 2.1.
238
239Added enhanced wxVTKRenderWindow by Prabhu Ramachandran
240
bf7945ce 241
9416aa89
RD
242
2432.3.0
19cf4f80
RD
244-----
245Removed initial startup dependency on the OpenGL DLLs so only the
9416aa89 246glcanvasc.pyd depends on them, (on wxMSW.)
19cf4f80
RD
247
248Changed wxFont, wxPen, wxBrush to not implicitly use the
9416aa89
RD
249wxThe[Font|Pen|Brush]List objects behind the scenes, but to use normal
250ctor and dtors.
19cf4f80
RD
251
252Exposed the wxThe[Font|Pen|Brush]List to wxPython.
253
1af9e5c5 254Also added wxTheColourDatabase and added a library module (in the
19cf4f80
RD
255wxPython.lib.colourdb module) to load LOTS more colour names into the
256colour database.
257
6e18ca6c
RD
258Added wxWakeUpMainThread, wxMutexGuiEnter, wxMutexGuiLeave,
259wxMutexGuiLocker and wxThread_IsMain to assist with dealing with GUI
260access from non-GUI threads.
261
1af9e5c5
RD
262wxPyOnDemandOutputWindow is now (more) thread safe if non-GUI threads
263use print, sys.stdout.write, etc.
6e18ca6c 264
6bb38ab6
RD
265Added CreateTextSizer and CreateButtonSizer to wxDialog
266
6bb38ab6
RD
267Added wxPython/lib/infoframe.py from Chris Fama. It contains a class
268that can be used in place of wxPyOnDemandOutputWindow.
269
49875c53
RD
270Added colourselect.py, imagebrowser.py and an updated calendar.py to
271wxPython/lib from Lorne White.
272
e0672e2f
RD
273Added patch to wxPoint_LIST_helper from Tim Hochberg that should make
274it gobs faster in certain situations.
6bb38ab6 275
1af9e5c5
RD
276Added tools that will take an image file in a wx supported format and
277convert it to data embedded in a Python source file. The image is
9416aa89
RD
278converted to XPM format which is essentially a list of strings
279containing info about each pixel. The image's transparency mask is
280included, if there is one, or a mask can be added if a mask colour is
281specified on the command line. It is then pickled and optionally
282compressed and written to a Python source file along with functions to
283convert it to either a wxBitmap or a wxImage. See
284wxPython/demo/images.py for examples, and wxPython/Tools/img2py.py for
285the implementation.
1af9e5c5
RD
286
287Fixed wxStyledTextCtrl to be much faster on wxGTK. There was some
288experimental code that got left in place that ended up causing way too
289many refreshes.
290
d1679124
RD
291A couple more hacks in my_distutils.py so wxPython can be built with
292the distutils that comes with Python 2.1.
1af9e5c5 293
d7ec6564 294Added a ton of missing methods for wxPrintData.
1af9e5c5 295
d7ec6564 296Switched to InnoSetup for MSW distributions.
19cf4f80 297
3b36695d
RD
298Added wxToggleButton.
299
300Fixed bug that prevented wxTreeCtrl.OnCompareItems from being called.
d1679124 301
9416aa89
RD
302Added some methods to wxGrid:
303 GetCellHighlightPenWidth
304 GetCellHighlightROPenWidth
305 SetCellHighlightPenWidth
306 SetCellHighlightROPenWidth
307 GetGridWindow
308 GetGridRowLabelWindow
309 GetGridColLabelWindow
310 GetGridCornerLabelWindow
311
312Added wxGetClientDisplayRect which on wxMSW returns a wxRect
313representing the area on screen not occupied by the taskbar and such.
314On other platforms it is equivallent to wxGetDisplaySize.
315
316
317***---***---***---***---***---***---***---***---***---***---***---
318 Implemented the first phase of OOR (Original Object Return). See
319 the text in the demo for more details of what this means, but in a
320 nutshell methods such as wxWindow.GetParent or FindWindowById will
321 now return a shadow object of the proper type if it can. By
322 "proper type" I mean that if the wxWindow pointer returned from
323 FindWindowById really points to a wxButton then the Python object
324 constructed will be of a wxButtonPtr class instead of wxWindowPtr
325 as before. This should reduce or eliminiate the need for
326 wxPyTypeCast. (Woo Hoo!) The objects returned are still not the
327 original Python object, but that is the next step. (Although it
328 will probably only work on Python 2.1 and beyond because it will
329 use weak references.)
330
331 This first phase of the OOR plan is fairly significant and has
332 required a lot of changes all over wxPython, most of which should
333 be transparent to you, however I'm not 100% sure that it didn't
334 introduce any new bugs that are hiding somewhere and didn't get
335 stomped on during my testing. So please be sure to test everything
336 thoroughly when you install this version and be sure to report any
337 object-type related oddities to me.
338***---***---***---***---***---***---***---***---***---***---***---
339
340There is now a wxObject class that most other classes derive from like
341in C++, but the methods provided don't really match but are wxPython
bf7945ce
RD
342specific. It could have been added long ago but OOR required it so it
343finally got done.
9416aa89
RD
344
345Finally added wxPyLineShape.GetLineControlPoints, which has been on my
346list for a while. The above OOR modification made this easier.
d1679124 347
10e07c70 348Fixed the __cmp__ methods for wxPoint and others.
419c299a 349
493f1553
RD
350Added wxWave.
351
30aaddfe
RD
352Added the wxPython.lib.mixins package to the library, it is where
353useful mix-in classes can be placed. Currently there is one to help
bf7945ce
RD
354make the columns in a wxListCtrl sortable, and the MagicIMageList from
355Mike Fletcher. If you have any custom code that can be factored out
356of existing classes into a mix-in that would be useful to others
30aaddfe
RD
357please send it to me for inclusion in this package.
358
25832b3f
RD
359Added a few little sample applications to help newbies to get started
360by having smaller functional apps to play with. They can be found in
361wxPython/samples.
362
493f1553 363
19cf4f80
RD
364
365
b075a3bb
RD
3662.2.6
367-----
368
369No changes happened in the Python wrappers for this release, only
370changes and fixes in the wxWindows library.
371
1b62f00d 372
19cf4f80 373
1b62f00d 3742.2.5
185d7c3e
RD
375-----
376
377New typemaps for wxString when compiling for Python 2.0 and beyond
378that allow Unicode objects to be passed as well as String objects. If
379a Unicode object is passed PyString_AsStringAndSize is used to convert
380it to a wxString using the default encoding.
381
382Fixed the generic buttons so tool tips work for them.
383
384Fixed a bug in the demo's tree control.
385
386Added a listbox to the listbox demo that shows how to find items with
1e7ecb7b 387a matching prefix as keys are typed.
185d7c3e
RD
388
389Added code to the wxListCtrl demo to show how to get text from a
390column in report mode.
391
392Added code to the toolbar demo to clear the long help from the status
393bar after 2 seconds.
394
395Added wxJoystick.
396
397Fixed wxTimer so it can be used as described in the docs, either with
398a Notify method in a subclass, or sending an event to a wxEvtHandler
399object, (usually a window.)
400
401Added wxNotifyEvent.Allow()
402
de20db99
RD
403Fixed GOBS of reference leaks.
404
1e7ecb7b
RD
405Massive code changes and cleanup to allow wxPython to be split into
406multiple extension modules again. A Python CObject is used to allow
1b62f00d
RD
407the "export" of SWIG functions and other common helper functions from
408the wxc module to other modules, even if they are in separate shared
1e7ecb7b
RD
409libraries. Should also be usable from 3rd party code, just include
410wxPython/src/export.h
411
412Changed the default setup so the following are built as separate
413extension modules: calendar, glcanvas, grid, html, ogl, stc, and
414utils. Will probably add more later.
415
1b62f00d
RD
416Changed the wxPrinterDC to use the new constructor taking a
417wxPrintData object. The old ctor is still there using the
418wxPrinterDC2 name.
419
420Added wxPython.lib.anchors.py from Riaan Booysen. It contains a class
421that implements Delphi's Anchors with wxLayoutConstraints.
422
423Added wxPython.lib.fancytext from Timothy Hochberg.
424
425Changed the GenericButtons to send their event in idle time, so the
426mouse won't be captured when the event handler is called.
427
428Added wxPython.lib.rpcMixin from Greg Landrum, although it's not
429integrated with the demo yet. It allows a wxPython GUI to be an
430XML-RPC server.
431
185d7c3e
RD
432
433
c368d904
RD
434New in 2.2.2
435------------
436
437Significantly changed how the wxStyledtextCtrl code that wraps
438Scintilla is implemented. Most of it is now automatically generated
439from an interface definition file provided by Scintilla. This means
440that it will be much easier to stay in sync with new Scintilla
441releases, but also means that some of the method and identifier names
442have changed. See wxPython/demo/data/stc.h for a copy of the C++
443interface from which the Python interface is generated. There is now
444some inline documentation in that file that should really help explain
445how things work.
446
447I am now using the Python Distutils to build wxPython and to make some
448of the distribution files. (See http://www.python.org/sigs/distutils-sig/)
449This means no more messing with my kludgy build.py/Makefile hack,
450builds will be more consistent with other Python extensions that also
451use Distutils, and will hopefully make wxPython easier to build for
452platforms where there have been troubles before. If you are building
453wxPython for Python 1.5.2 or for 1.6, then you will need to get and
454install version 1.0 of Distutils from the website above. If you are
455using Python 2.0 then you already have it.
456
457Added wxInputStream and the wxFileSystem family of classes,
458contributed by Joerg Baumann.
459
460Added wxProcess and support for it to wxExecute. wxProcess lets you
461get notified when an asyncronous child process terminates, and also to
462get input/output streams for the child process's stdout, stderr and
463stdin.
464
465Removed the old python sizers.
466
467Added __add__, __sub__ and __cmp__ (equality check only) for wxPoint
468and wxRealPoint.
469
470Changed the build to make one big extension module instead of one for
471the core and each contrib. This allowed me to do away with the
472libwxPyHelpers.so on unix systems.
473
474Lots of little fixes here and there.
475
476Some hacks on wxGTK to try and make the AutoComplete listbox in the
477wxStyledTextCtrl to behave better. It's still not as nice as on
478wxMSW, but at least it's a bit more usable now.
479
480
481
482
3ca6a5f0
BP
483New in 2.2.1
484------------
485
486Various tweaks, fixes, missing methods, etc.
487
c368d904
RD
488Added example use of wxTaskBarIcon to the demo.
489
3ca6a5f0
BP
490
491
f6bcfd97
BP
492New in 2.2.0
493------------
494
495Added wxLog and friends.
496
497Added wxFrame.ShowFullScreen for MSW.
498
499Added PyShellWindow to the wxPython.lib package.
500
501
502
503New in 2.1.16
504-------------
505
506Added an attribute named labelDelta to the generic buttons that
507specifies how far to offset the label when the button is in the
508depressed state.
509
510Added wxTipProvider and friends. See the demo for an example.
511
512wxGrid can now change the cell highlight colour.
513
514Added wxDragImage.
515
516Fixed printing on wxGTK.
517
518Added wxDateTime, wxTimeSpan, and wxDateSpan to wxPython.utils.
519
520Added wxCalendarCtrl.
521
522WARNING: A while back I asked what should be done about the Magic
523Method Names. (Methods that are automatically turned into event
524handlers by virtue of their name.) The consensus was that it is more
525confusing to have them than to try and expand them to have greater
526coverage. I am finally getting around to removing the code that
527generates the event binding. This means that if you are using any of
528the following method names without a EVT_* call that you need to
529modify your code to add the EVT_* to hook the event to the method.
530
531 OnChar
532 OnSize
533 OnEraseBackground
534 OnSysColourChanged
535 OnInitDialog
536 OnPaint
537 OnIdle
538 OnActivate
539 OnMenuHighlight
540 OnCloseWindow
541 OnScroll
542
543Added wxSpinCtrl.
544
545
546
547
548New in 2.1.15
164b735b
RD
549-------------
550
551Fixed wxTreeCtrl.HitTest to return both the tree item as well as the
552flags that clairify where the click was in relation to the item.
553
854862f5
RD
554Fixed thread state problem in wxTreeCtrl.GetBoundingBox and
555GetSelections.
164b735b 556
99ab9f3b
RD
557Fixed some problems in OGL. Also wxShape.SetClientData and
558.GetClientData can now deal with Python objects.
714d23b4 559
dcd38683 560Added wxListCtrl.SortItems and changed the demo to show how to use it.
714d23b4 561
f6bcfd97
BP
562Plugged a memory leak.
563
564Wrapped the new wxGrid and friends. The old wxGrid class is no longer
565available. There are some incompatibilities, and unfortunately the
566new classes are not documented yet, (however the methods are more
567consistent with each other now so you may be able to guess pretty
568good...)
569
570Updated filebrowsebutton.py and calendar.py with changes from their
571authors. There is now a FileBrowseButtonWithHistory class (what a
572mouthful!) and wxCalendar has printing support.
573
574Added ActiveXWrapper to the library, and some good demos of it too.
575It works great for embedding a COM (a.k.a OCX, a.k.a ActiveX) control
576in a window and calling its methods. It actually creates a new class
577on the fly that derives from wxWindow, the COM CoClass and others
578needed to make it all work. The resulting class can be instantiated
579just like wxWindow, used in sizers, etc. It also responds to all COM
580method calls, properties, etc., and if the class or a mix-in has
581matching method names, then the COM events will be propogated back to
582them.
583
584Created a typemap that allows a string to be used for parameters
585expecting a wxColour type. The string is either a colour name as
586defined in the wxColourDatabase, or a colour spec of the form
587"#RRGGBB". See the wxStyledTextCtrl demo for an example.
588
589I almost forgot to mention the wxStyledTextCtrl! Yes, the
590wxStyledTextCtrl is finally in wxPython!! (And the crowd goes
591wild...) There's no documentaTion yet (the crowd boos and hisses...)
592but I've included a very readable source file in the
593wxPython/demo/data directory, a couple fairly good examples, and you
594can also refer to the Scintilla documentaion at
595http://www.scintilla.org/ScintillaDoc.html to help fill in the gaps
596until the docs are done. (The croud murmers contentedly as the tool
597provider smiles convincingly and removes his flame-proof suit.)
598
164b735b
RD
599
600
601
9e57c2a0 602What's new in 2.1.13
6d75ea8f 603--------------------
9e57c2a0
RD
604Skipped a version number to match what has been released for wxGTK.
605
6d75ea8f
RD
606Updated wxMVCTree and added a demo for it, also fixed layout on GTK
607and some flicker problems.
608
609Added a wrapper class for the Visualization ToolKit (or VTK) in the
610wxPython.lib.vtk module. (http://www.kitware.com/)
611
612Fixed wxTreeCtrl.SetItemImage and GetItemImage to recognise the new
613"which" parameter.
614
615Added wxPython.lib.spashscreen from Mike Fletcher.
616
617Added wxPython.lib.filebrowsebutton also from Mike Fletcher.
618
619Renamed wxTreeCtrl.GetParent to GetItemParent to avoid a name clash
620with wxWindow.GetParent.
621
622Added wxIntersectRect to compute the intersection of two wxRect's.
623It is used like this:
624
625 intersect = wxIntersectRect(rect1, rect2)
626
627If r1 and r2 don't intersect then None is returned, otherwise the
628rectangle representing the intersection is returned.
629
630Some bug fixes for Clipboard and Drag-n-Drop.
631
9b3d3bc4 632Rotated text!!! WooHoo! (See wxDC.DrawRotatedText())
6999b0d8
RD
633
634Added a set of Generic Buttons to the library. These are simple
635window classes that look and act like native buttons, but you can have
636a bit more control over them. The bezel width can be set in addition
637to colours, fonts, etc. There is a ToggleButton as well as Bitmap
9e57c2a0
RD
638versions too. They should also serve as a good example of how to
639create your own classes derived from wxControl.
6d75ea8f 640
9b3d3bc4
RD
641The C++ wxToolBar classes have been redone, and so have the wxPython
642wrappers. There have been slight modifications to some of the methods
643but shouldn't impact anybody too much. I took the opportunity to add
644support for setting user data on each toolbar tool. The new AddTool
645methods look like this:
646
647 def AddTool(ID,
648 bitmap,
649 pushedBitmap = wxNullBitmap,
650 toggle = FALSE,
651 clientData = NULL,
652 shortHelpString = "",
653 longHelpString = "")
654
655 def AddSimpleTool(ID,
656 bitmap,
657 shortHelpString = "",
658 longHelpString = "",
659 toggle=FALSE)
660
661
662There are also coresponding InsertTool and InsertSimpleTool methods
663that additionally take an integer position as the first parameter.
664
9e57c2a0 665Added a wrapper for the new PCX and TIFF ImageHandlers.
9b3d3bc4
RD
666
667wxRect now simulates attributes named left, right, top and bottom.
668
d2103cf2
RD
669Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
670is better and compatible with the wxGLCanvas. You can get it at
671http://starship.python.net:9673/crew/da/Code/PyOpenGL.
9b3d3bc4 672
3af4e610 673Added some missing EVT_ functions.
9b3d3bc4 674
1b55cabf
RD
675Added Dirk Holtwic's editor classes to the wxPython.lib.editor
676package.
677
eec92d76
RD
678Changed all the "LIST" parameter names to "choices" to match the docs.
679
fe366bc9
RD
680More fixes for the wxFloatBar, and it now works on wxGTK even better
681than wxMSW! (The feat is accomplished by using the wxTB_DOCKABLE
682style flag instead of trying to float it ourselves.)
683
9b3d3bc4 684
6d75ea8f
RD
685
686
687What's new in 2.1.11
688--------------------
689Skipped a few version numbers so wxMSW, wxGTK and wxPython are all
690syncronized.
691
692wxImage.SetData now makes a copy of the image data before giving it to
693wxImage. I mistakenly thought that wxImage would copy the data
694itself.
695
696Fixed wxMSW's notebook so the pages get their size set as they are
697being added. This should remove the need for our
698wxNotebook.ResizeChildren hack.
699
700wxPanels now support AutoLayout, and wxNotebooks and wxSplitterWindows
701no longer tell their children to Layout() themselves. This will
702probably only effect you if you have a wxWindow with AutoLayout inside
703a notebook or splitter. If so, either change it to a wxPanel or add
704an EVT_SIZE handler that calls Layout().
705
706Fixed deadlock problem that happened when using threads.
707
708Added new HTML printing classes.
709
710Added wxWindow.GetHandle
711
712Apparently wxMouseEvent.Position has been depreciated in wxWindows as
713it is no longer available by default. You can use GetPositionTuple
714(returning a tuple with x,y) instead, or GetPosition (returning a
715wxPoint.)
716
717Added wxPostEvent function that allows events to be posted and then
718processed later. This is a thread-safe way to interact with the GUI
719thread from other threads.
720
721Added Clipboard and Drag-and-Drop classes.
722
723Added wxFontEnumerator.
724
725Many updates to wxMenu, wxMenuBar.
726
727wxPyEvent and wxPyCommandEvent derived classes now give you the actual
728Python object in the event handler instead of a new shadow.
729
730Added a Calendar widget from Lorne White to the library.
731
732Made some fixes to the wxFloatbar. It still has some troubles on
733wxGTK...
734
735Added an MVC tree control from Bryn Keller to the library.
736
737
738
739
740What's new in 2.1.5
741-------------------
742This is a quick bug-fix release to take care of a few nasties that
743crept in at the last minute before 2.1.4 was called done. No new
744major features.
745
746
747
748What's new in 2.1.4
749--------------------
750
751This release is NOT syncronized with a snapshot release of wxGTK or
752wxMSW. For MSW this isn't much of a problem since you can get the
753binaries from the web site. For other platforms you'll have to build
754wxGTK from CVS. (See http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm)
755To get the same set of sources from CVS that I used, checkout using
756the wxPy-2-1-4 tag.
757
758Now back to what's new...
759
760Much more support for event-less callbacks and add-on modules.
761
762Created add-on module with wxOGL classes.
763
764Added wxWindow.GetChildren(). Be careful of this. It returns a *copy*
765of the list of the window's children. While you are using the list if
766anything changes in the real list (a child is deleted, etc.) then the
767list you are holding will suddenly have window references to garbage
768memory and your app will likely crash. But if you are careful it works
769great!
770
771Added a bunch of new and missing methods to wxTreeCrtl. The
772SortChildren method is now supported, but currently only for the
773default sort order.
774
775Added typemaps for wxSize, wxPoint, wxRealPoint, and wxRect that allow
776either the actual objects or Python sequence values to be used. For
777example, the following are equivallent:
778
779 win = wxWindow(parent, size = wxSize(100, 100))
780 win = wxWindow(parent, size = (100, 100))
781
782Super-charged the wxHtml module. You can now create your own tag
783handlers and also have access to the parser and cell classes. There
784is a tag handler in the library at wxPython.lib.wxpTag that
785understands the WXP tag and is able to place wxPython windows on HTML
786pages. See the demo for an example.
787
788A bunch of the methods of wxMenuBar were previously ifdef'd out for
789wxGTK. Added them back in since the methods exist now.
790
791Wrapped the wxHtmlHelpController and related classes.
792
793Wrapped the C++ versions of wxSizer and friends. The Python-only
794versions are still in the library, but depreciated. (You will get a
795warning message if you try to use them, but the warning can be
796disabled.) The usage of the C++ versions is slightly different, and
797the functionality of wxBorderSizer is now part of wxBoxSizer. I have
798added a few methods to wxSizer to try and make the transition as
799smooth as possible, I combined all Add methods into a single method
800that handles all cases, added an AddMany method, etc. One step I did
801not take was to make the default value of flag in the Add method be
802wxGROW. This would have made it more backward compatible, but less
803portable to and from wxWin C++ code. Please see the docs and demo for
804further details.
805
806Added wxPyEvent and wxPyCommandEvent classes, derived from wxEvent and
807wxCommandEvent. Each of them has SetPyData and GetPyData methods that
808accept or return a single Python object. You can use these classes
809directly or derive from them to create your own types of event objects
810that can pass through the wxWindows event system without loosing their
811Python parts (as long as they are stored with SetPyData.) Stay tuned
812for more info and examples in future releases.
813
814Added wxPython.lib.grids as an example of how to derive a new sizer
815from the C++ sizers. In this module you will find wxGridSizer and
816wxFlexGridSizer. wxGridSizer arrainges its items in a grid in which
817all the widths and heights are the same. wxFlexgridSizer allows
818different widths and heights, and you can also specify rows and/or
819columns that are growable. See the demo for a couple examples for how
820to use them.
821
822Added the wxValidator class, and created a class named wxPyValidator
823that should be used for the base class of any Python validators. See
824the demo for an example. Please note that you MUST implement a Clone
825method in your validator classes because of the way some things work
826in the underlying C++ library. I did not add wxTextValidator because
827of some issues of how it transfers data to and from a wxString, which
828in wxPython is automatically translated to and from Python strings, so
829there would never be a concrete wxString that would hang around long
830enough for the validator to do its job. On the other hand, it should
831be real easy to duplicate the functionality of wxTextValidator in a
832pure Python class derived from wxPyValidator.
833
834I've finally added a feature that has been on my list for close to two
835years! Ever wondered what that zero is for when you create your app
836object? Well now you can leave it out or explicitly set it to a true
837value. This value now controls what is to be done with sys.stdout and
838sys.stderr. A false value leaves them alone, and a true value sets
839them to an instance of wxPyOnDemandOutputWindow. (On windows the
840default is true, on unix platforms the default is false.) This class
841creates a frame containing a wxTextCtrl as soon as anything is written
842to sys.stdout or sys.stderr. If you close the window it will come
843back again the next time something is written. (You can call
844app.RestoreStdio to turn this off.) If you would rather that the stdio be
845redirected to a file, you can provide a second parameter to your app
846object's constructor that is a filename. If you want to use your own
847class instead of wxPyOnDemandOutputWindow you can either implement
848RedirectStdio() in you app class or change the value of
849wxApp.outputWindowClass like this:
850
851 class MyApp(wxApp):
852 outputWindowClass = MyClass
853
854 def OnInit(self):
855 frame = MyFrame()
856 self.SetTopWindow(frame)
857 return true
858
859Please see the implementation of wxPyOnDemandOutputWindow and wxApp in
860wx.py for more details. A few words of caution: if you are running
861your app in a debugger, changing sys.stdout and sys.stderr is likely
862to really screw things up.
863
864Added wxCaret. Unfortunately it's author has still not documented it
865in the wxWindows docs...
866
867Some new 3rd party contributions in wxPython.lib. PyShell, in
868shell.py is an interesting implementaion of an interactive Python
869shell in wxWindows. floatbar.py has a class derived from wxToolBar
870that can sense mouse drags and then reparent itself into another
871frame. Moving the new frame close to where it came from puts the tool
872bar back into the original parent. (Unfortunately there is currently
873a bug in wxGTK's wxFrame.SetToolBar so the FloatBar has some
874problems...)
875
876
877
878
879What's new in 2.1b3
880--------------------
881
882This release is syncronized with release 2.1 snapshot 9 of wxWindows.
883
884Switched to using SWIG from CVS (see http://swig.cs.uchicago.edu/cvs.html)
885for some of the new features and such. Also they have encorporated my
886patches so there is really no reason to stick with the current (very
887old) release... This version of SWIG gives the following new
888features:
889
890 1. Keyword arguments. You no longer have to specify all the
891 parameters with defaults to a method just to specify a
892 non-default value on the end. You can now do this instead:
893
894 win = wxWindow(parent, -1, style = mystyle)
895
896 2. There is now an an equivalence between Python's None and C++'s
897 NULL. This means that any methods that might return NULL will
898 now return None and you can use none where wxWindows might be
899 expecting NULL. This makes things much more snake-ish.
900
901
902There is a new build system based on a new Python program instead of
903raw makefiles. Now wxPython builds are virtually the same on MSW or
904Unix systems. See the end of this file for new build instructions and
905see distrib/build.py for more details.
906
907wxDC.Bilt now includes the useMask parameter, and has been split into
908two different versions. wxDC.BlitXY is like what was there before and
909takes raw coordinants and sizes, and the new wxDC.Blit is for the new
910interface using wxPoints and a wxSize.
911
912
913
914
915
916What's new in 2.1b2
917--------------------
918
919Added the missing wxWindow.GetUpdateRegion() method.
920
921Made a new change in SWIG (update your patches everybody) that
922provides a fix for global shadow objects that get an exception in
923their __del__ when their extension module has already been deleted.
924It was only a 1 line change in .../SWIG/Modules/pycpp.cxx at about
925line 496 if you want to do it by hand.
926
927It is now possible to run through MainLoop more than once in any one
928process. The cleanup that used to happen as MainLoop completed (and
929prevented it from running again) has been delayed until the wxc module
930is being unloaded by Python.
931
932I fixed a bunch of stuff in the C++ version of wxGrid so it wouldn't
933make wxPython look bad.
934
935wxWindow.PopupMenu() now takes a wxPoint instead of x,y. Added
936wxWindow.PopupMenuXY to be consistent with some other methods.
937
938Added wxGrid.SetEditInPlace and wxGrid.GetEditInPlace.
939
940You can now provide your own app.MainLoop method. See
941wxPython/demo/demoMainLoop.py for an example and some explaination.
942
943Got the in-place-edit for the wxTreeCtrl fixed and added some demo
944code to show how to use it.
945
946Put the wxIcon constructor back in for GTK as it now has one that
947matches MSW's.
948
949Added wxGrid.GetCells
950
951Added wxSystemSettings static methods as functions with names like
952wxSystemSettings_GetSystemColour.
953
954Removed wxPyMenu since using menu callbacks have been depreciated in
955wxWindows. Use wxMenu and events instead.
956
957Added alternate wxBitmap constructor (for MSW only) as
958 wxBitmapFromData(data, type, width, height, depth = 1)
959
960Added a helper function named wxPyTypeCast that can convert shadow
961objects of one type into shadow objects of another type. (Like doing
962a down-cast.) See the implementation in wx.py for some docs.
963
964Fixed wxImage GetData and SetData to properly use String objects for
965data transfer.
966
967Added access methods to wxGridEvent.
968
969New Makefile/Setup files supporting multiple dynamic extension modules
970for unix systems.
971
972Fixes for the wxGLCanvas demo to work around a strange bug in gtk.
973
974SWIG support routines now compiled separately instead of being bundled
975in wx.cpp.
976
977
978
979
980
981What's new in 2.1b1
982--------------------
983Fixed wxComboBox.SetSelection so that it actually sets the selected
984item. (Actually just removed it from wxPython and let it default to
985wxChoice.SetSelection which was already doing the right thing.)
986
987Added the Printing Framework.
988
989Switched back to using the wxWindows DLL for the pre-built Win32
990version. The problem was needing to reinitialize static class info
991data after loading each extension module.
992
993Lots of little tweaks and additions to reflect changes to various
994wxWindows classes.
995
996Fixed a bug with attaching objects to tree items. Actually was a
997symptom of a larger problem with not obtaining the interpreter lock
998when doing any Py_DECREFs.
999
1000wxSizer and friends. Sizers are layout tools that manage a colection
1001of windows and sizers. Different types of sizers apply different
1002types of layout algorithms. You saw it here first! These classes are
1003not even in the wxWindows C++ library yet!
1004
1005
1006
1007What's new in 2.0b9
1008-------------------
1009Bug fix for ListCtrl in test4.py (Was a missing file... DSM!)
1010
1011Bug fix for occassional GPF on Win32 systems upon termination of a
1012wxPython application.
1013
1014Added wxListBox.GetSelections returning selections as a Tuple.
1015
1016Added a wxTreeItemData that is able to hold any Python object and be
1017associated with items in a wxTreeCtrl. Added test pytree.py to show
1018this feature off.
1019
1020Added wxSafeYield function.
1021
1022OpenGL Canvas can be optionally compiled in to wxPython.
1023
1024Awesome new Demo Framework for showing off wxPython and for learning
1025how it all works.
1026
1027The pre-built Win32 version is no longer distributing the wxWindows
1028DLL. It is statically linked with the wxWindows library instead.
1029
1030Added a couple missing items from the docs.
1031
1032Added wxImage, wxImageHandler, wxPNGHandler, wxJPEGHandler,
1033wxGIFHandler and wxBMPHandler.
1034
1035Added new methods to wxTextCtrl.
1036
1037Fixed some problems with how SWIG was wrapping some wxTreeCtrl
1038methods.
1039
1040
1041
1042What's new in 2.0b8
1043-------------------
1044Support for using Python threads in wxPython apps.
1045
1046Several missing methods from various classes.
1047
1048Various bug fixes.
1049
1050
1051
1052What's new in 2.0b7
1053-------------------
1054Added DLG_PNT and DLG_SZE convienience methods to wxWindow class.
1055
1056Added missing constructor and other methods for wxMenuItem.
1057
1058
1059
1060What's new in 2.0b6
1061-------------------
1062Just a quickie update to fix the self-installer to be compatible with
1063Python 1.5.2b2's Registry settings.
1064
1065
1066What's new in 2.0b5
1067-------------------
1068Well obviously the numbering scheme has changed. I did this to
1069reflect the fact that this truly is the second major revision of
1070wxPython, (well the third actually if you count the one I did for
1071wxWindows 1.68 and then threw away...) and also that it is associated
1072with the 2.0 version of wxWindows.
1073
1074I have finally started documenting wxPython. There are several pages
1075in the wxWindows documentation tree specifically about wxPython, and I
1076have added notes within the class references about where and how wxPython
1077diverges from wxWindows.
1078
1079Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
1080window handle. If you can get the window handle into the python code,
1081it should just work... More news on this later.
1082
1083Added wxImageList, wxToolTip.
1084
1085Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
1086wxRegConfig class.
1087
1088As usual, some bug fixes, tweaks, etc.
1089
1090
1091
1092What's new in 0.5.3
1093-------------------
1094Added wxSashWindow, wxSashEvent, wxLayoutAlgorithm, etc.
1095
1096Various cleanup, tweaks, minor additions, etc. to maintain
1097compatibility with the current wxWindows.
1098
1099
1100
1101What's new in 0.5.0
1102-------------------
1103Changed the import semantics from "from wxPython import *" to "from
1104wxPython.wx import *" This is for people who are worried about
1105namespace pollution, they can use "from wxPython import wx" and then
1106prefix all the wxPython identifiers with "wx."
1107
1108Added wxTaskbarIcon for wxMSW.
1109
1110Made the events work for wxGrid.
1111
1112Added wxConfig.
1113
1114Added wxMiniFrame for wxGTK.
1115
1116Changed many of the args and return values that were pointers to gdi
1117objects to references to reflect changes in the wxWindows API.
1118
1119Other assorted fixes and additions.
1120
1121
1122
1123
1124What's new in 0.4.2
1125-------------------
1126
1127wxPython on wxGTK works!!! Both dynamic and static on Linux and
1128static on Solaris have been tested. Many thanks go to Harm
1129<H.v.d.Heijden@phys.tue.nl> for his astute detective work on tracking
1130down a nasty DECREF bug. Okay so I have to confess that it was just a
1131DSM (Dumb Stupid Mistake) on my part but it was nasty none the less
1132because the behavior was so different on different platforms.
1133
1134The dynamicly loaded module on Solaris is still segfaulting, so it
1135must have been a different issue all along...
1136
1137
1138
1139What's New in 0.4
1140-----------------
1141
11421. Worked on wxGTK compatibility. It is partially working. On a
1143Solaris/Sparc box wxPython is working but only when it is statically
1144linked with the Python interpreter. When built as a dyamically loaded
1145extension module, things start acting weirdly and it soon seg-faults.
1146And on Linux both the statically linked and the dynamically linked
1147version segfault shortly after starting up.
1148
11492. Added Toolbar, StatusBar and SplitterWindow classes.
1150
11513. Varioius bug fixes, enhancements, etc.
1152
1153----------------------------------------------------------------------