]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/docs/CHANGES.txt
Applied new master define for CommandBar vs. PocketPC mixed bar.
[wxWidgets.git] / wxPython / docs / CHANGES.txt
index 1628f4f375f12c50a63cd1da8b4b7cabadac5d01..0b812f7ef5446f54ff45519bd1ca16fec996d6de 100644 (file)
-CHANGES.txt for wxPython
+Recent Changes for wxPython
+=====================================================================
 
-----------------------------------------------------------------------
+2.5.2.1
+-------
+
+wx.ADJUST_MINSIZE is now the default behaviour for window items in
+sizers.  This means that the item's GetMinSize and/or GetBestSize will
+be called when calculating layout and the return value from that will
+be used for the minimum size used by the sizer.  The wx.FIXED_MINSIZE
+flag was added that will cause the sizer to use the old behaviour in
+that it will *not* call the window's methods to determine the new best
+size, instead the minsize that the window had when added to the sizer
+(or the size the window was created with) will always be used.  
+
+Related to the above, when controls and some other window types are
+created either the size passed to the constructor, or their "best
+size" if an explicit size was not passed in, is set as the window's
+minimal size.  For non top-level windows that hasn't meant much in the
+past, but now the sizers are sensitive to the window's minimal size.
+The key point to understand here is that it is no longer the window's
+size it has when added to the sizer that matters, but its minimal
+size.  So you might have some issues to iron out if you create a
+control without a size and then set its size to something before
+adding it to the sizer.  Since it's minimal size is probably not the
+size you set then the sizer will appear to be misbehaving.  The fix is
+to either set the size when calling the window's constructor, or to
+reset the min size by calling SetSizeHints.  You can call SetSizeHints
+at anytime to change the minsize of a window, just call the sizer's
+Layout method to redistribute the controls as needed.
+
+
+Added new MaskedEditControl code from Will Sadkin.  The modules are
+now locaed in their own sub-package, wx.lib.masked.  Demos updated.
+
+The changes that implemented the incompatible wx.DC methods in 2.5.1.5
+have been reverted.  The wx.DC methods are now compatible with the 2.4
+implemetation.  In addition a set of renamed methods have been added
+that take wx.Point and/or wx.Size objects instead of individual
+parameters. 
+
+Added wx.lib.mixins.listctrl.TextEditMixin, a mixin class that allows
+all columns of a wx.ListCtrl in report mode to be edited.
+
+Deprecated the wx.iewin module.
+
+Deprecated the wx.Sizer.AddWindow, AddSizer, AddSpacer methods as well
+as their Insert* and Prepend* counterparts.
+
+Added a generic StaticBitmap class in wx.lib.statbmp for the same
+reasons that stattext was created, so it could be mouse sensitive on
+all platforms like normal windows.  Also updated stattext.py and
+buttons.py to handle attribute (font & colour) defaults and
+inheritance the new way.  If you have custom controls of your own you
+should review stattxt.py or one of the others to see how it is to be
+done.
+
+wx.InitAllImageHandlers is now an empty function that does nothing but
+exist for backwards compatibility.  The C++ version is now called
+automatically when wxPython is initialized.  Since all the handlers
+are included in the wxWidgets shared library anyway, this imposes only
+a very small amount of overhead and removes several unneccessary
+problems.
+
+Replaced wx/lib/pubsub.py with a version that uses weak references to
+track the subscribers, plus other fixes/additions.  Thanks go to
+Oliver Schoenborn and Robb Shecter.
+
+wxGTK now uses gtk_init_check so wxPython can raise an exception if
+there is no DISPLAY available or other initializaion problem.
+
+wx.GetKeyState now has an implementation for wxGTK and is able to
+detect the up/down or toggle state of modifier and toggle keys.
+
+The LC_NUMERIC locale is now reset back to "C" (compatibility) when
+running on wxGTK to work around the fact that GTK requires the locale
+to be set to the system settings but Python depends on LC_NUMERIC
+remaining compatible with "C".
+
+Switched gizmos.TreeListCtrl to the newer version of the code from the
+wxCode project.
+
+OGL is dead! LONG LIVE OGL!  (Oops, sorry.  A bit of my dramatic side
+leaked out there...)  The wx.ogl module has been deprecated in favor
+of the new Python port of the OGL library located at wx.lib.ogl
+contributed by Pierre Hjälm.  This will hopefully greatly extend the
+life of OGL within wxPython by making it more easily maintainable and
+less prone to getting rusty as there seems to be less and less
+interest in maintaining the C++ version.  At this point there are just
+a couple minor known compatibility differences, please see the
+MigrationGuide_ file for details.
+
+.. _MigrationGuide: MigrationGuide.html
+
+EVT_STC_POSCHANGED has been removed as it has been deprecated in
+Scintilla for several releases now.
 
-2.5.1.x
+All the Window and GDI (pen, bitmap, etc.) class constructors and also
+many toplevel functions and static methods will now check that a
+wx.App object has already been created and will raise a
+wx.PyNoAppError exception if not.
+
+Added more default args as needed to allow most window types to be
+constructed with only the parent window arg.  In some cases other args
+may be required for normal operation, but they can usually be set
+after construction.
+
+Removed the deprecated ErrorDialogs and PythonBitmaps modules.  If you
+were using these in your apps then please join wxPython-dev and assist
+with a more modern reimplementation.
+
+Added a new version (0.8.3) of FloatCanvas from Chris Barker.  It's now
+in a subpackage of wx.lib.
+
+
+
+
+2.5.1.5
 -------
 
-(See also the MigrationGuide.txt file for details about some of the
+(See also the MigrationGuide_ file for details about some of the
 big changes that have happened in this release and how you should
 adapt your code.)
 
+.. _MigrationGuide: MigrationGuide.html
+
+
+The wxWindows project and library is now known as wxWidgets.  Please
+see http://www.wxwindows.org/name.htm for more details.  This won't
+really affect wxPython all that much, other than the fact that the
+wxwindows.org domain name will be changing to wxwidgets.org, so mail
+list, CVS, and etc. addresses will be changing.  We're going to try
+and smooth the transition as much as possible, but I wanted you all to
+be aware of this change if you run into any issues.
+
+
 Many, many little fixes, changes and additions done as part of the move
-to wxWindows 2.5 that I have forgotten about.
+to wxWidgets 2.5 that I have forgotten about.
 
 Added wxMirrorDC.
 
 Added wxIconLocation
 
-Added Python wrappers for the new wxVScrolledWindow, wxVListBox, and
-wxHtmlListBox classes.
+Added Python wrappers and demos for the new wxVScrolledWindow,
+wxVListBox, and wxHtmlListBox classes.
 
 Added wrappers for wxBookCtrl and wxListbook.  wxNotebook now derives
 from wxBookCtrl.
@@ -29,26 +154,78 @@ I made a small but important change in the code that aquires the
 Python Global Interpreter Lock to try and prevent deadlocks that can
 happen when there are nested attempts to aquire the GIL.
 
-The RPMs will now install menu items on Mandrake in
-Applications/Development/Tools for PyCrust, XRCed, etc.  They are also
-installing icons and *.desktop items in the generic KDE and GNOME
-locations, but I don't know yet if they are resulting in menu items on
-non-Mandrake systems.  (It didn't automatically do it on my RH-9 build
-box but I didn't chase it very far...)  If you have ideas for how to
-improve the .spec file to work better and/or on more distros please
-send me a patch.
+The RPMs will now install menu items on Mandrake Linux in
+Applications/Development/Tools for PyCrust, XRCed, etc.  The RPMs are
+also installing icons and ``*.desktop`` items in the generic KDE and
+GNOME locations, but I don't know yet if they are resulting in menu
+items on non-Mandrake systems.  (It didn't automatically do it on my
+RH-9 build box but I didn't chase it very far...)  If you have ideas
+for how to improve the .spec file to work better and/or on more
+distros please send me a patch.
 
-The RPMs are now built on a RH-9 box, and I have tested installing
-them also on my main Mandrake 9.2 box.
+The RPMs are now built on a fairly generic RH-9 box, and I have tested
+installing them also on my main Mandrake 9.2 box.
 
 There are some big changes in the OS X disk image.  The actual
 Installer package now *only* installs the wxMac dynlibs, wxPython
-extension modules and pacakges, and also the command-line tool
+extension modules and Python packages, and also the command-line tool
 scripts. The remaining items (demo, samples, and application bundles
 for the Demo, PyCrust and XRCed) are now top-level items in the disk
 image (.dmg file) that users can just drag and drop to wherever they
 want to put them.
 
+The wxWave class has been renamed to wxSound, and now has a slightly
+different API.
+
+Updated the AnalogClockWindow with many enhancements from E. A. Tacão.
+
+wxMac now has wx.ToggleButton!
+
+wx.stc.StyledTextCtrl has been updated to version 1.58 of Scintilla.
+
+To help with the wx.stc.StyledTextCtrl performance issues on wxMac
+I've added a SetUseAntiAliasing method (and GetUseAntiAliasing too)
+that will turn off the use of antialiased fonts in the wxSTC, allowing
+it to bypass the slow text measuring routines and use the fast and
+simple one instead.  By default the setting is turned off (on wxMac
+only.)  When run on OSX the Py* apps have a new item on the Options
+menu for controlling this setting if you would like to experiment with
+it.
+
+Updated wx.lib.calendar with many fixes and enhancements from Joerg
+"Adi" Sieker. 
+
+Added wx.Display and wx.VideoMode.
+
+AppleEvents can be handled by overriding wx.App methods MacOpenFile,
+MacPrintFile, MacNewFile, and MacReopenApp.
+
+Added wx.PlatformInfo which is a tuple containing strings that
+describe the platform and build options of wxPython.  See the
+MigrationGuide for more details.
+
+Created a new extension module "activex" from Lindsay Mathieson's
+newest wxActiveX_ class.  (The existing iewin module used an older
+version of this code, but only exposed the wxIEHtmlWin class.)  This
+new module will (in theory ;-) ) allow you to host arbitrary ActiveX
+controls in a wx.Window, **without** requiring the use of the win32com
+and other PyWin32 modules!  This should eliminate the cronic problems
+that have resulted from minor mismatches in how PyWin32 handles the
+GIL and tstate when making callbacks, etc.  The older iewin module
+will be left in this release as the new stuff is not fully backwards
+compatible, but you should migrate your code to the new IEHtmlWindow
+in wx.lib.iewin, so the old one can be eventually removed.
+Additionally, I've always considered that the wx.lib.activexwrapper
+module is an ugly hack that I only included in the lib because I
+couldn't figure out anything better.  Well now we have something that,
+if it isn't already, has the potential to be better.  So consider
+migrating away from using activexwrapper as well.  Please see the
+MigrationGuide for more details on using the new module.
+
+.. _wxActiveX: http://members.optusnet.com.au/~blackpaw1/wxactivex.html
+
+Floats are allowed again as function parameters where ints are expected.
+
 
 
 
@@ -78,7 +255,7 @@ Added wxScrolledPanel from Will Sadkin
 Added SetShape method to top level windows (e.g. wxFrame.)
 
 Changed wxSWIG to not generate Python code using apply, (since it will
-be deprecated in the future) wxSWIG will use spam(*args, **kw) syntax
+be deprecated in the future) wxSWIG will use ``spam(*args, **kw)`` syntax
 instead.  Also changed the generated __repr__ methods to be a bit more
 informative.
 
@@ -88,7 +265,7 @@ and wxWindows match.
 
 Added the new wx "renamer" package that will dynamically import from
 the wxPython package and rename wxFooBar --> FooBar.  That means that
-people can do imports without "import *" and can use names like
+people can do imports without ``"import *"`` and can use names like
 wx.Frame instead of wx.wxFrame.  This is phase 1 of a full transition
 to the new namespace.
 
@@ -145,6 +322,7 @@ Added wxCursorFromBits.
 
 2.4.0.7
 -------
+
 Gave up on generating a warning upon the use of the old true/false or
 TRUE/FALSE values.
 
@@ -172,7 +350,8 @@ details.
 
 
 2.4.0.6 (a.k.a. the I'm so stupid release)
--------
+------------------------------------------
+
 The new deprecation class for the old true/false symbols can now be
 returned from OnInit.  And I promise to be sure I am testing what I
 think I am testing in the future...
@@ -180,7 +359,8 @@ think I am testing in the future...
 
 
 2.4.0.5 (a.k.a. the blame it on Kevin release)
--------
+----------------------------------------------
+
 A few little but annoying bug fixes.
 
 Updated pycolourchooser.
@@ -765,8 +945,7 @@ Added wxGetClientDisplayRect which on wxMSW returns a wxRect
 representing the area on screen not occupied by the taskbar and such.
 On other platforms it is equivallent to wxGetDisplaySize.
 
-
-***---***---***---***---***---***---***---***---***---***---***---
+OOR:
    Implemented the first phase of OOR (Original Object Return).  See
    the text in the demo for more details of what this means, but in a
    nutshell methods such as wxWindow.GetParent or FindWindowById will
@@ -787,7 +966,7 @@ On other platforms it is equivallent to wxGetDisplaySize.
    stomped on during my testing.  So please be sure to test everything
    thoroughly when you install this version and be sure to report any
    object-type related oddities to me.
-***---***---***---***---***---***---***---***---***---***---***---
+
 
 There is now a wxObject class that most other classes derive from like
 in C++, but the methods provided don't really match but are wxPython
@@ -1122,7 +1301,7 @@ Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
 is better and compatible with the wxGLCanvas.  You can get it at
 http://starship.python.net:9673/crew/da/Code/PyOpenGL.
 
-Added some missing EVT_ functions.
+Added some missing EVT functions.
 
 Added Dirk Holtwic's editor classes to the wxPython.lib.editor
 package.
@@ -1552,8 +1731,8 @@ compatibility with the current wxWindows.
 
 What's new in 0.5.0
 -------------------
-Changed the import semantics from "from wxPython import *" to "from
-wxPython.wx import *"  This is for people who are worried about
+Changed the import semantics from ``"from wxPython import *"`` to 
+``"from wxPython.wx import *"``  This is for people who are worried about
 namespace pollution, they can use "from wxPython import wx" and then
 prefix all the wxPython identifiers with "wx."
 
@@ -1602,4 +1781,5 @@ version segfault shortly after starting up.
 
 3. Varioius bug fixes, enhancements, etc.
 
-----------------------------------------------------------------------
+
+