]> git.saurik.com Git - wxWidgets.git/blame - wxPython/docs/CHANGES.html
Don't embed the style sheet
[wxWidgets.git] / wxPython / docs / CHANGES.html
CommitLineData
8eda5e35
RD
1<?xml version="1.0" encoding="iso-8859-1" ?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
974a50f1 6<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
73adcb01 7<title>Recent Changes for wxPython</title>
c04bcba0 8<link rel="stylesheet" href="default.css" type="text/css" />
8eda5e35
RD
9</head>
10<body>
73adcb01
RD
11<div class="document" id="recent-changes-for-wxpython">
12<h1 class="title">Recent Changes for wxPython</h1>
974a50f1 13<div class="section">
c04bcba0
RD
14<h1><a id="id1" name="id1">2.7.2.0</a></h1>
15<ul class="simple">
16<li>7-Nov-2006</li>
17</ul>
18<p>Patch [ 1583183 ] Fixes printing/print preview inconsistencies</p>
19<p>Add events API to wxHtmlWindow (patch #1504493 by Francesco Montorsi)</p>
20<p>Added wxTB_RIGHT style for right-aligned toolbars (Igor Korot)</p>
21<p>Added New Zealand NZST and NZDT timezone support to wx.DateTime.</p>
22<p>wx.Window.GetAdjustedBestSize is deprecated. In every conceivable
23scenario GetEffectiveMinSize is probably what you want to use instead.</p>
24<p>wx.Image: Gained support for TGA image file format.</p>
25<p>wx.aui: The classes in the wx.aui module have been renamed to be more
26consistent with each other, and make it easier to recognize in the
27docs and etc. that they belong together.</p>
28<blockquote>
29FrameManager --&gt; AuiManager
30FrameManagerEvent --&gt; AuiManagerEvent
31PaneInfo --&gt; AuiPaneInfo
32FloatingPane --&gt; AuiFloatingPane
33DockArt --&gt; AuiDockArt
34TabArt --&gt; AuiTabArt
35AuiMultiNotebook --&gt; AuiNotebook
36AuiNotebookEvent --&gt; AuiNotebookEvent</blockquote>
37<p>wx.lib.customtreectrl: A patch from Frame Niessink which adds an
38additional style (TR_AUTO_CHECK_PARENT) that (un)checks a parent when
39all children are (un)checked.</p>
40<p>wx.animate.AnimationCtrl fixed to display inactive bitmap at start
41(patch 1590192)</p>
42<p>Patch from Dj Gilcrease adding the FNB_HIDE_ON_SINGLE_TAB style flag
43for wx.lib.flatnotebook.</p>
44<p>wx.Window.GetBestFittingSize has been renamed to GetEffectiveMinSize.
45SetBestFittingSize has been renamed to SetInitialSize, since it is
46most often used only to set the initial (and minimal) size of a
47widget.</p>
48<p>The QuickTime backend for wx.media.MediaCtrl on MS Windows works
49again. Just pass szBackend=wx.media.MEDIABACKEND_QUICKTIME to the
50constructor to use it instead of the default ActiveMovie backend,
51(assuming the quicktime DLLs are available on the system.)</p>
52</div>
53<div class="section">
54<h1><a id="id2" name="id2">2.7.1.3</a></h1>
49db0f3f
RD
55<ul class="simple">
56<li>26-Oct-2006</li>
57</ul>
58<p>wxGTK: The wx.ALWAYS_SHOW_SB style is now supported.</p>
59<p>Fixed name errors in the old wxPython package namespace. As a
60reminder, use of this package is deprecated and you are encouraged to
61switch your programs over to the wx package.</p>
62<p>Fixed wx.glcanvas.GLCanvas.SetCurrent to be compatible with prevoius
63versons.</p>
64<p>Added wx.StandardPaths.GetTmpDir.</p>
65<p>Bug fixes in the wx.ListCtrl on Mac from Kevin Olivier, allowing it to
66send events properly again. There is also a new native implementation
67of wx.ListCtrl available, which will be used for wx.LC_REPORT style
68list controls if you set the &quot;mac.listctrl.always_use_generic&quot;
69SystemOption to zero. In a future release this will be the default.</p>
70<p>Added a sample to the demo that shows some of what can be done with
71the new wx.GraphicsContext and wx.GraphicsPath classes.</p>
72</div>
73<div class="section">
c04bcba0 74<h1><a id="id3" name="id3">2.7.1.2</a></h1>
0cf04a42
RD
75<ul class="simple">
76<li>21-Oct-2006</li>
77</ul>
78<p>Fixed a bug in the MaskedEdit controls caused by conflicting IsEmpty
79methods.</p>
80<p>Patch #1579280: Some mimetype optimizations on unix-like systems.</p>
81<p>wxMac: Several wx.webkit.WebKitCtrl enhancements/fixes, including:</p>
82<blockquote>
83<ul class="simple">
84<li>new methods for increasing/decreasing text size, getting
85selection, getting/setting scroll position, printing, enabling
86editing, and running JavaScripts on the page.</li>
87<li>added new event (wx.webkit.WebKitBeforeLoadEvent) for catching, and
88possibly vetoing, load events before they occur.</li>
89<li>wx.webkit.WebKitCtrl now fires mouse events for certain events
90that it was eating before. This improves wxSplitterWindow
91resizing behavior.</li>
92<li>refactoring of the sizing logic to move the Cocoa view. Tested
93with splitter windows, panels, notebooks and all position
94correctly with this.</li>
95</ul>
96</blockquote>
97<p>Some improvements to the drawing code in CustomTreeCtrl.</p>
98<p>Fixed refcount leak in wx.Window.GetChildren.</p>
99</div>
100<div class="section">
c04bcba0 101<h1><a id="id4" name="id4">2.7.1.1</a></h1>
974a50f1
RD
102<ul class="simple">
103<li>18-Oct-2006</li>
104</ul>
105<p>The following deprecated items have been removed:</p>
106<blockquote>
107<ul class="simple">
108<li>wx.Bitmap SetQuality and GetQuality methods</li>
109<li>The wx.GetNumberFromUser function</li>
110<li>wx.EVT_LIST_GET_INFO and wx.EVT_LIST_SET_INFO</li>
111<li>wx.BookCtrlSizer and wx.NotebookSizer</li>
112<li>The PostScript-specific methods of wx.PrintData</li>
113<li>wx.PrintDialogData SetSetupDialog and GetSetupDialog methods</li>
114<li>wx.FontMapper SetConfig method</li>
115<li>wx.html.HtmlSearchStatus.GetContentsItem method</li>
116<li>wx.html.HtmlHelpData.GetContents, GetContentsCnt, GetIndex, and
117GetIndexCnt methods</li>
118</ul>
119</blockquote>
120<p>wx.EventLoop is now implemented for wxMac.</p>
121<p>Added wxPython wrappers for the new wx.Treebook and wx.Toolbook
122classes.</p>
123<p>wx.DC.BeginDrawing and EndDrawing have been deprecated in the C++
124code, so since they never really did anything before they are now just
125empty stubs in wxPython.</p>
126<p>Solved a problem that has been around for a very long time in how C++
127methods are virtualized for overriding in derived Python classes.
128Previously we couldn't do it for methods that needed to also exist in
129the base class wrappers such that they could be called normally. (The
130reasons are long and complex, but suffice it to say that it was due to
131mixing C++'s dynamic dispatch, and Python's runtime lookup of the
132method attributes resulting in endless recursion of function calls.)
133Because of this problem I used a hack that I have always hated, and
134that is renaming the base class methods with a &quot;base_*&quot; prefix, for
135example wx.Printout.base_OnBeginDocument. Now that the problem has
136finally been solved I have replaced all the base_Whatever() methods
137with the real Whatever() method as well as a simple wrapper named
138base_Whatever that is marked as deprecated. So now instead of writing
139your overridden methods like this:</p>
140<pre class="literal-block">
141def OnBeginDocument(self, start, end):
142 # do something here
143 return self.base_OnBeginDocument(start, end)
144</pre>
145<p>You can now call the base class method the normal way, like this:</p>
146<pre class="literal-block">
147def OnBeginDocument(self, start, end):
148 # do something here
149 return Printout.OnBeginDocument(self, start, end)
150</pre>
151<p>Or like this with super():</p>
152<pre class="literal-block">
153def OnBeginDocument(self, start, end):
154 # do something here
155 return super(MyPrintout, self).OnBeginDocument(start, end)
156</pre>
157<p>Note that the old way with the &quot;base_*&quot; function still works, but you
158will get a DeprecationWarning from calling base_OnBeginDocument. The
159classes affected by this are:</p>
160<blockquote>
161<ul class="simple">
162<li>wx.DropSource</li>
163<li>wx.DropTarget</li>
164<li>wx.TextDropTarget</li>
165<li>wx.FileDropTarget</li>
166<li>wx.PyLog (also added the ability to override Flush)</li>
167<li>wx.PyApp (also added the ability to override ExitMainLoop)</li>
168<li>wx.Printout</li>
169<li>wx.PyPrintPreview</li>
170<li>wx.PyPreviewFrame</li>
171<li>wx.PreviewControlBar</li>
172<li>wx.Process</li>
173<li>wx.PyControl</li>
174<li>wx.PyPanel</li>
175<li>wx.PyScrolledWindow</li>
176<li>wx.PyWindow</li>
177<li>wx.Timer</li>
178<li>wx.grid.PyGridCellRenderer</li>
179<li>wx.grid.PyGridCellEditor</li>
180<li>wx.grid.PyGridCellAttrProvider</li>
181<li>wx.grid.PyGridTableBase</li>
182<li>wx.html.HtmlWindow</li>
183<li>wx.wizard.PyWizardPage</li>
184</ul>
185</blockquote>
186<p>Added the wx.DC.GradientFillConcentric and wx.DC.GradientFillLinear
187methods.</p>
188<p>wxGTK: wx.ListBox and wx.CheckListBox are now using native GTK2
189widgets.</p>
190<p>Added wx.ListBox.HitTest() from patch 1446207</p>
191<p>Bumped up to SWIG 1.3.29. This provides some more runtime performance
192boosts, gets rid of the dreaded Ptr classes, and some other nice new
193things.</p>
194<p>Added wx.Window.GetScreenPosition and GetScreenRect which returns the
195position of the window in screen coordinates, even if the window is
196not a top-level window.</p>
197<p>Added GetResourcesDir and GetLocalizedResourcesDir to
198wx.StandardPaths.</p>
199<p>Added a GetReceivedFormat method to wx.DataObjectComposite. You can
200use this to find out what format of data object was recieved from the
201source of the clipboard or DnD operation, and then you'll know which
202of the component data objects to use to access the data.</p>
203<p>Changed how the stock objects (wx.RED, wx.RED_PEN, wx.RED_BRUSH, etc.)
204are initialized. They are now created as uninitialized instances
205using __new__. Then after the wx.App has been created, but before
0cf04a42 206OnInit is called, the .this attribute of each object is initialized.
974a50f1
RD
207This was needed because of some delayed initialization functionality
208that was implemented in wxWidgets, but the end result is cleaner for
209wxPython as well, and allowed me to remove some ugly code previously
210hidden under the covers.</p>
211<p>Added wx.StandardPaths.GetDocumentsDir.</p>
212<p>Added wx.RendererNative.DrawCheckButton.</p>
213<p>wx.ProgressDialog.Update now returns a tuple of two values. The first
214is a continue flag (what was returned before) and the second is a skip
215flag. If the dialog has the wx.PD_CAN_SKIP flag and if the Skip
216button is clicked, then the skip flag is set to True the next time
217Update is called.</p>
218<p>A DeprecationWarning is now issued when the old wxPython package is
219imported. If you are still using the old namespace please convert
220your code to use the new wx package instead.</p>
221<p>Added wrappers for Julian's new wxRichTextCtrl class, visible in
222wxPython as wx.richtext.RichTextCtrl window. It still needs some more
223work, but it is a great start.</p>
224<p>wx.lib.mixins.listctrl.TextEditMixin: Fixed the double END_LABEL_EDIT
225event problem in TextEditMixin by checking if the editor was already
226hidden before continuing with the CloseEditor method. Also added code
227to OpenEditor to send the BEGIN_LABEL_EDIT event and to not allow the
228opening of the editor to continue if the event handler doesn't allow
229it.</p>
230<p>wx.StaticBoxSizer now keeps better track of the wx.StaticBox, and it
231will destroy it if the sizer is destroyed before the parent window is.</p>
232<p>Added wx.HyperlinkCtrl.</p>
233<p>Added battery and power related functions and events (wxMSW only so
234far.) See wx.PowerEvent, wx.GetPowerType and wx.GetBatteryState.</p>
235<p>Added wx.ListCtrl.HitTestSubItem which returns the sub-item (i.e. the
236column in report mode) that was hit (if any) in addition to the item
237and flags.</p>
238<p>Added wrappers for wx.ColourPickerCtrl, wx.DirPickerCtrl,
239wx.FilePickerCtrl, and wx.FontPickerCtrl.</p>
240<p>Patch #1502016 wx.Image.ConvertToGreyscale now retains the alpha
241channel.</p>
242<p>Added wrappers for the wxAUI classes, in the wx.aui module.</p>
243<p>Added the PseudoDC class from Paul Lanier. It provides a way to
244record operations on a DC and then play them back later.</p>
245<p>Upgraded to Scintilla 1.70 for wx.stc.StyledTextCtrl.</p>
246<p>Added CanSetTransparent and SetTransparent methods to the
247wx.TopLevelWindow class, with implementations (so far) for wxMSW and
248wxMac.</p>
249<p>SetDefaultItem() and GetDefaultItem() are now members of
250wx.TopLevelWindow, not wx.Panel.</p>
251<p>wxGTK: Stock items (icons) will be used for menu items with stock
252IDs.</p>
253<p>Added wx.lib.combotreebox from Frank Niessink</p>
254<p>Added wx.ImageFromBuffer, wx.BitmapFromBuffer and
255wx.BitmapFromBufferRGBA factory functions. They enable loading of an
256image or bitmap directly from a Python object that implements the
257buffer interface, such as strings, arrays, etc.</p>
258<p>Added wx.App.IsDisplayAvailable() which can be used to determine if a
259GUI can be created in the current environment. (Still need an
260implementation for wxMSW...)</p>
261<p>The wx.html.HTML_FONT_SIZE_x constants are no longer available as the
262default sizes are now calculated at runtime based on the size of the
263normal GUI font.</p>
264<p>wx.Colour now includes an alpha component, which defaults to
265wx.ALPHA_OPAQUE. This is in preparation for allowing various new
266alpha blening functionality using wx.Colour objects, such as drawing
267with pens and brushes on a wx.DC.</p>
268<p>Added wx.NativePixelBuffer, wx.AlphPixelBuffer and related iterator
269and accessor classes. They allow platform independent direct access
270to the platform specific pixel buffer inside of a wx.Bitmap object.</p>
271<p>The beginnings of support for RTL languages has been added, thanks to
272a Google SoC project.</p>
273<p>Added wx.lib.dragscroller from Riaan Booysen. It provides a helper
274class that can used to scroll a wx.ScrolledWindow in response to a
275mouse drag.</p>
276<p>Applied patch 1551409: Adds support for indeterminate mode gauges.</p>
277<p>wxMac: I've turned on the compile option for using the native toolbar
278on the Mac now that it supports hosting of controls. If the toolbar
279is managed by the frame via either CreateToolBar() or SetToolBar()
280then the native toolbar will be used. Additional toolbars, or
281toolbars that are not children of the frame, are managed by sizers or
282what-not will still use the emulated toolbar because of platform
283restrictions in how/where the native toolbar can be used.</p>
284<p>Added Python properties for many of the getter/setter methods of wx
285classes. In order for the names to be predicatble for somebody
286already familiar with wxPython the property names are simply the name
287of the getter with the &quot;Get&quot; dropped. For example, wx.Window has a
288property named &quot;Size&quot; that maps to GetSize and SetSize. So far there
289is only one known name conflict using this naming convention, and that
290is wx.KeyEvent.KeyCode, however since KeyCode was formerly a
291compatibility alias for GetKeyCode (and has been for a long time) it
292was decided to just switch it to a property. If you want to use the
293method then change your calls to event.KeyCode() to
294event.GetKeyCode(), otherwise you can use it as a property just by
295dropping the parentheses.</p>
296<p>Updated the C++ code for wx.gizmos.TreeListCtrl from the wxCode
297project. This has resulted in some minor API changes, most of which
298were worked around in the wrapper code.</p>
299<p>Added wx.lib.delayedresult from Oliver Schoenborn.</p>
300<p>Added wx.lib.expando, a multi-line textctrl that exands as more lines
301are needed.</p>
302<p>wx.Image.Scale and Rescale methods now take an extra parameter
303specifying type of method to use for resampling the image. It
304defaults to the current behavior of just replicating pixels, if
305wx.IMAGE_QUALITY_HIGH is passed then it uses bicubic and box averaging
306resampling methods for upsampling and downsampling respectively.</p>
307<p>Added the wx.lib.buttonpanel module, which is a tweaked version of
308Andrea Gavana's FancyButtonPanel module.</p>
309<p>Added the wx.lib.flatnotebook module, from Andrea Gavana.</p>
310<p>Renamed wx.FutureCall to wx.CallLater so it is named more like
311wx.CallAfter. wx.FutureCall is now an empty subclass of wx.CallLater
312for compatibility of older code.</p>
0cf04a42 313<p>Added the wx.lib.customtreectrl module from Andrea Gavana.</p>
974a50f1
RD
314<p>Added ChangeSelection to wx.BookCtrl (the base class for wx.Notebook
315and other book controls) that is the same as SetSelection but doesn't
316send the change events.</p>
317<p>Added wx.TextCtrl.ChangeValue() which is the same as SetValue() but
318doesn't send the text changed event.</p>
319<p>For consistency, all classes having an Ok() method now also have
320IsOk(), use of the latter form is preferred although the former hasn't
321been deprecated yet</p>
322<p>Added the wx.AboutBox() function and wx.AboutDialogInfo class. They
323provide a way to show a standard About box for the application, which
324will either be a native dialog or a generic one depending on what info
325is provided and if it can all be shown with the native dialog.</p>
326<p>The code in the animate contrib has been moved into the code wxWidgets
327library, and refactored a bit along the way. For wxPython it still
328exists in the wx.animate module, but has basically been reduced to two
329classes, wx.animate.Animation, and wx.animate.AnimationCtrl. You load
330the animated GIF (and hopefully there will be other supported formats
331in the near future) in the Animation object, and then give that to the
332AnimatedCtrl for display. See the demo for an example. There is also
333still a GIFAnimationCtrl class that provides some level of backwards
334compatibility with the old implementation.</p>
335<p>wxMac: The compile option that turns on the use of CoreGraphics (a.k.a
336Quartz) for wxDC is now turned on by default. This means that all
337drawing via wxDC is done using the new APIs from apple, instead of the
338old Quick Draw API. There are, however, a few places where Quartz and
339wxDC don't fit together very well, mainly the lack of support for
340logical drawing operations such as XOR, but there is work in progress
341to provide other ways to do the same sort of thing that will work with
342Quartz and also on the other platforms.</p>
343<p>The first parts of a new 2D drawing API has been added with the
344wx.GraphicsPath and wx.GraphicsContext classes. They wrap GDI+ on
345Windows, Cairo on wxGTK and CoreGraphics on OS X. They allow path-based
346drawing with alpha-blending and anti-aliasing, and use a floating
347point cooridnate system. Currently they can only target drawing to
348windows, but other wx.DC backends are forthcoming. The APIs may
349evolve a bit more before they are finalaized with the 2.8 release, but
350there is enough there now to get a good feel for how things will work.
351There is also a transitional wx.GCDC class that provides the wx.DC API
352on top of wx.GraphicsContext. Docs and a demo are still MIA.</p>
353<p>Added a wx.AutoBufferedPaintDC that is a subclass of wx.PaintDC on
354platforms that do double buffering by default, and a subclass of
355wx.BufferedPaintDC on the platforms that don't. You can use this
356class to help avoid the overhead of buffering when it is not
357needed. There is also a wx.AutoBufferedPaintDCFactory function that
358does a little more and actually tests if the window has
359double-buffering enabled and then decides whether to return a
360wx.PaintDC or wx.BufferedPaintDC. This uses the new
361wx.Window.IsDoubleBuffered method.</p>
362</div>
363<div class="section">
c04bcba0 364<h1><a id="id5" name="id5">2.6.3.3</a></h1>
974a50f1
RD
365<ul class="simple">
366<li>15-July-2006</li>
367</ul>
368<dl class="docutils">
369<dt>wx.lib.pubsub updates from Oliver Schoenborn:</dt>
370<dd><ul class="first last simple">
371<li>fixed the hash problem with non-hashable objects</li>
372<li>now supports listeners that use *args as an argument
373(listener(*args) was not passing the validity test)</li>
374<li>corrected some mistakes in documentation</li>
375<li>added some clarifications (hopefully useful for first time
376users)</li>
377<li>changed the way singleton is implemented since old way prevented
378pydoc etc from extracting docs for Publisher</li>
379</ul>
380</dd>
381<dt>DocView and ActiveGrid IDE updates from Morgan Hua:</dt>
382<dd>New Features: In Tab-View mode, Ctrl-number will take the user to
383the numbered tab view. Modified files now show an '*' astrisk in
384the view title. Debugger framework can now support PHP debugging.
385Not important for python development, but at least that means the
386debugger framework is more generalized.</dd>
387</dl>
388<p>wx.lib.mixins.listctrl.TextEditMixin: Fixed the double END_LABEL_EDIT
389event problem in TextEditMixin by checking if the editor was already
390hidden before continuing with the CloseEditor method. Also added code
391to OpenEditor to send the BEGIN_LABEL_EDIT event and to not allow the
392opening of the editor to continue if the event handler doesn't allow
393it.</p>
394<p>Undeprecated wx.GetNumberFromUser and added wx.NumberEntryDialog.</p>
395<p>Made necessaary changes for building wxPython for Python 2.5. There
396may still be some issues related to the new Py_ssize_t type and 64-bit
397machines, but at least all compile errors and warnings related to it
398have been resolved.</p>
399</div>
400<div class="section">
c04bcba0 401<h1><a id="id6" name="id6">2.6.3.2</a></h1>
974a50f1
RD
402<ul class="simple">
403<li>3-April-2006</li>
404</ul>
405<p>Fixed reference leak in wx.gizmos.TreeListCtrl.GetSelections.</p>
406<p>wxMSW: Fixed sizing issue with wx.Choice and wx.ComboBox. This change
407was implemented by reverting a prior fix for a different problem
408(contiuous painting/resizing when a combobox is used as a widget in a
409wx.html.HtmlWindow) so a method to fix both problems is still being
410investigated.</p>
411<p>wxGTK: Fixed potential buffer overrun when pasting from the
412clipboard.</p>
413<p>Fixed problem in wx.lib.splitter when used on 64-bit platforms. Used
414the current length of the list for specifying an append instead of
415sys.maxint.</p>
416<p>wxMSW: Support added for XP themed owner drawn buttons and bitmap
417buttons. For example, if you change the foreground color of a button
418it will now be drawn with the XP themed style rather than an ugly
419generic button style.</p>
420<p>XRCed: Fix for Copy/Paste objects with international characters.</p>
421<p>Fixed the equality and inequality operators for some of the basic
422data types (wx.Point, wx.Size, wx.Colour, etc.) to no longer raise a
423TypeError if the compared object is not compatible, but to just return
424a boolean as expected. For example:</p>
425<pre class="literal-block">
426wx.Colour(64,0,64) == 123 ==&gt; False
427</pre>
428<p>wxMSW: Fixed (again) sizing/positioning issues of calling Realize on
429a wx.ToolBar that is not manaaged directly by a frame and that is
430already shown.</p>
431<p>wxMSW: Fixed wx.Choice/wx.ComboBox so they send events when a new item
432is selected only with the keyboard.</p>
433</div>
434<div class="section">
c04bcba0 435<h1><a id="id7" name="id7">2.6.3.0</a></h1>
974a50f1
RD
436<ul class="simple">
437<li>27-March-2006</li>
438</ul>
439<p>Change the wx.ListCtrl InsertStringItem wrapper to use the form that
440takes an imageIndex, and set the default to -1. This ensures that on
441wxMSW that if there is an image list but they don't specify an image,
442the native control doesn't use one anyway.</p>
443<p>wxMSW: wx.ListCtrl in report mode is now able to support images in
444other columns besides the first one. Simply pass an image index to
445SetStringItem. For virtual list controls you can specify the image to
446use on the extra columns by overriding OnGetItemColumnImage in your
447derived class. It is passed the item number and the column number as
448parameters, and the default version simply calls OnGetItemImage for
449column zero, or returns -1 for other columns.</p>
450<p>Switched to using SWIG 1.3.27 for generating the wrapper code. There
451are some small changes needed to SWIG to work around some bugs that
452wxPython exposes, and to be able to generate code that matches that
453which wxPython is using. If you are building wxPython yourself and
454need to modify any of the *.i files or to add your own, then you will
455want to be sure to use a matching SWIG. See wxPython/SWIG/README.txt
456in the source tarball for details.</p>
457<p>wx.Image.Copy, Mirror, and GetSubImage now also do the right thing
458with the alpha channel.</p>
459<p>wxMSW: Fixed problem in wx.TextCtrl where using SetValue and
460wx.TE_RICH2 would cause the control to be shown if it was hidden.</p>
461<p>wxMSW: Numpad special keys are now distinguished from normal keys in
462key events.</p>
463<p>wxMSW: Multiline notebook tab label change now resizes the control
464correctly if an extra row is removed or added.</p>
465<p>wxMSW: On XP fall back to unthemed wxNotebook if specified orientation
466not available in the themed version.</p>
467<p>Added wx.Toolbar.GetToolsCount.</p>
468<p>Added wx.GridSizer.CalcRowsCols.</p>
469<p>Added wx.OutputStream.LastWrite.</p>
470<p>wxGTK: EVT_SET_CURSOR is now sent.</p>
471<p>wxGTK: Fix RequestMore for idle events.</p>
472<p>wxGTK: Implement user dashes for PS and GNOME printing.</p>
473<p>wxGTK: Correct update region code. Don't always invalidate the whole
474window upon resize. Reenable support for thewx.NO_FULL_REPAINT_ON_RESIZE
475flag. Also disable refreshing custom controls when focusing in and out.</p>
476<p>wx.lib.pubsub: Publisher is now able to parse a dotted notation string
477into a topic tuple. For example: subscribing to &quot;timer.clock.seconds&quot;
478is the same as subscribing to (&quot;timer&quot;, &quot;clock&quot;, &quot;seconds&quot;).</p>
479<p>Applied patch #1441370: lib.plot - allow passing in wx.Colour()</p>
480<p>Added wx.CommandEvent.GetClientData.</p>
481<p>Updated wxStyledTextCtrl to use version 1.67 of Scintilla.
482NOTE: The STC_LEX_ASP and STC_LEX_PHP lexers have been deprecated,
483you should use STC_LEX_HTML instead.</p>
484<p>wxSTC: Implemented Fix for SF Bug #1436503. Delay the start of the
485DnD operation in case the user just intended to click, not drag.</p>
486<p>Updated the analogclock.py module to the new analogclock package from
487E. A. Tacao.</p>
488<p>Added the wx.lib.mixins.listctrl.CheckListCtrlMixin class from Bruce
489Who, which makes it easy to put checkboxes on list control items.</p>
490<p>Applied a patch from Christian Kristukat to wx.lib.plot that adds
491scrollbars when the plot is zoomed in, and also the ability to grab a
492zoomed plot and move it around with a mouse drag.</p>
493<p>XRCed updated to allow wxMenuBar to be created inside a wxFrame.</p>
494<p>Added wx.StandardPaths.GetDocumentsDir() (patch 1214360)</p>
495</div>
496<div class="section">
c04bcba0 497<h1><a id="id8" name="id8">2.6.2.1</a></h1>
17991ec0
RD
498<ul class="simple">
499<li>10-Jan-2006</li>
500</ul>
095315e2
RD
501<p>wxMSW: Fix for bug #1211907, popup menu indenting inconsistent with
502bitmaps.</p>
503<p>wxMac: Don't send an event for wx.RadioButton deselections, just the
504selections. This was done to make it consistent with the other
505platforms.</p>
506<p>wxMSW: Always set flat toolbar style, even under XP with themes: this
507is necessary or separators aren't shown at all.</p>
508<p>Fixes for bug #1217872, pydocview.DocService not correctly initialized.</p>
509<p>Fix for bug #1217874, Error in parameter name in DocManager.CreateView.</p>
510<p>Added wrappers for the wx.RendererNative class.</p>
511<p>Added the wx.lib.splitter module, which contains the
512MultiSplitterWindow class. This class is much like the standard
513wx.SplitterWindow class, except it allows more than one split, so it
514can manage more than two child windows.</p>
515<p>Docview and IDE patch from Morgan Hua with fix for bug #1217890
516&quot;Closing view crashes Python&quot; plus some new features:</p>
974a50f1 517<blockquote>
095315e2
RD
518New feature added to the IDE is 'Extensions'. Under
519Tools|Options|Extensions, you can add calls to external programs.
520For example you can add a &quot;Notepad&quot; extension (under windows) that
521will exec Notepad on the currently open file. A new &quot;Notepad&quot;
974a50f1 522menu item will appear under the Tools menu.</blockquote>
095315e2
RD
523<p>Some fixes to XRCed to make encoding errors a bit more user friendly.</p>
524<p>XRCed changes from Roman Rolinsky:</p>
525<blockquote>
526<ul class="simple">
527<li>Added new controls (Choicebook, Listbook, StatusBar,
528DatePicker), and completed style flags. Test window is opened
529for an available parent control if no specific view
530defined. Better handling of exceptions (highlighting does not
531'stick' anymore).</li>
532<li>Use system clipboard for Copy/Paste.</li>
533<li>Improved some dialogs (window styles, growable cols). Changed
534the range for wxSpinCtrl min/max to all integers (default 0/100
535is not always good).</li>
536</ul>
537</blockquote>
538<p>Updates for wx.lib.foldpanelbar and wx.lib.hyperlink from Andrea
539Gavana.</p>
540<p>Fix for Bug #1283496: wxPython TheClipboard class causes problems for
541pychecker. Ensure the app has been created before initializing
542wx.TheClipboard.</p>
543<p>Fix for Bug #1352602: FileBrowseButtonWithHistory can't type in Value.</p>
544<p>wxHTML: Added space after list item number.</p>
545<p>wx.lib.printout: Applied patch #1384440.</p>
546<p>wxMSW: Fix for Bug #1293225 Window_FromHWND crashes if parent is
547None.</p>
548<p>Fix for Bug #1261669, use a wx.TE_RICH2 style for the Process demo so
549it doesn't fill up too soon.</p>
550<p>Applied Patch #1354389: wxPython MenuItem SetBitmaps fix.</p>
551<p>Applied Patch #1239456: wxPython wx.DataObject.GetAllFormats fix.</p>
552<p>Applied Patch # #1230107 which allows image handlers to be written in
553Python by deriving from wx.PyImageHandler.</p>
554<p>Applied patch #1072210: generalize printout.py to allow text printing.</p>
555<p>Applied patch #1243907: Give Throbber much more flexibility by
556allowing the user to set the rest image, the direction, the current
557index, custom sequence. Allows user to manually step through the
558sequence with Next(), Previous(), Increment(), Decrement() &amp;
559SetCurrent(). Very handy if you have multiple throbbers that you want
560to synchronize with a single timer.</p>
561<p>Fix for bug #1336711: wx.lib.calendar.CalenDlg can yield incorrect
562result.</p>
563<p>Applied patch from Morgan Hua for updates to ActiveGrid code
564(pydocview, ActiveGrid IDE, etc.)</p>
565<p>Applied patch #1326241: Supporting &quot;setup.py install --install-headers=path&quot;</p>
566<p>Applied patch from Morgan Hua to fix bug #1219423: CommandManager
567should not repeat old commands after a branch.</p>
568<p>Applied patch #1238825 adding search backward capabilities to the
569demo. Modified to use the up/down options in the wx.FindReplaceDialog
570instead of a separate menu item.</p>
571<p>Fix for bug #1266745 and #1387725 in the wx.FindReplaceDialog on MSW.
572Actually check we are using MSLU before doing the hack designed to
573workaround a bug in MSLU!</p>
574<p>wxMSW: wx.lib.iewin.IEHtmlWindow now properly handles tabbing, return
575and other special keys properly.</p>
576<p>Lots of PyCrust enhancments started by Franz Steinaeusler, Adi Sieker,
577and Sebastian Haase, and which in turn were further enhanced, fixed
578tweaked and finished up by me. The changes include the following:</p>
579<blockquote>
580<ul class="simple">
581<li>The Autocomplete and Calltip windows can now be opened manually
582with Ctrl-Space and Ctrl-Shift-Space.</li>
583<li>In the stand alone PyCrust app the various option settings,
584window size and position, and etc. are saved and restored at the
585next run.</li>
586<li>Added a help dialog bound to the F1 key that shows the key
587bindings.</li>
588<li>Added a new text completion function that suggests words from
589the history. Bound to Shift-Return.</li>
590<li>F11 will toggle the maximized state of the frame.</li>
591<li>switched to Bind() from wx.EVT_*().</li>
592<li>Display of line numbers can be toggled.</li>
593<li>F12 toggles a &quot;free edit&quot; mode of the shell buffer. This mode
594is useful, for example, if you would like to remove some output
595or errors or etc. from the buffer before doing a copy/paste.
596The free edit mode is designated by the use of a red,
597non-flashing caret.</li>
486afba9 598<li>Ctrl-Shift-F will fold/unfold (hide/show) the selected lines.</li>
095315e2
RD
599<li>General code cleanup and fixes.</li>
600<li>Use wx.StandardPaths to determine the location of the config
601files.</li>
602<li>Use wx.SP_LIVE_UPDATE on crust and filling windows.</li>
603<li>Extended the saving of the config info and other new features to
604the PyShell app too. Additionally, other apps that embed a
605PyCrust or a PyShell can pass their own wx.Config object and
606have the Py code save/restore its settings to/from there.</li>
607<li>All of the classes with config info get an opportunity to
608save/load their own settings instead of putting all the
609save/load code in one place that then has to reach all over the
610place to do anything.</li>
611<li>Enable editing of the startup python code, which will either be
612the file pointed to by PYTHONSTARTUP or a file in the config dir
613if PYTHONSTARTUP is not set in the environment.</li>
614<li>Added an option to skip the running of the startup code when
615PyShell or PyCrust starts.</li>
616<li>PyCrust adds a pp(item) function to the shell's namespace that
617pretty prints the item in the Display tab of the notebook.
618Added code to raise that tab when pp() is called.</li>
619<li>Added an option for whether to insert text for function
620parameters when popping up the call tip.</li>
621<li>Added Find and Find-Next functions that use the
622wx.FindReplaceDialog.</li>
623</ul>
624</blockquote>
625<p>Applied patches from Will Sadkin for wx.lib.masked modules:</p>
626<blockquote>
627<ul class="simple">
628<li>Now ignores kill focus events when being destroyed.</li>
629<li>Added missing call to set insertion point on changing fields.</li>
630<li>Modified SetKeyHandler() to accept None as means of removing
631one.</li>
632<li>Fixed keyhandler processing for group and decimal character
633changes.</li>
634<li>Fixed a problem that prevented input into the integer digit of a
635integerwidth=1 numctrl, if the current value was 0.</li>
636<li>Fixed logic involving processing of &quot;_signOk&quot; flag, to remove
637default sign key handlers if false, so that
638SetAllowNegative(False) in the NumCtrl works properly.</li>
639<li>Fixed selection logic for numeric controls so that if
640selectOnFieldEntry is true, and the integer portion of an
641integer format control is selected and the sign position is
642selected, the sign keys will always result in a negative value,
643rather than toggling the previous sign.</li>
644</ul>
645</blockquote>
646<p>wx.FontMapper.SetConfig is deprecated. You should instead just set an
647application-wide config object with wx.Config.Set, which wx.FontMapper
648will use by default.</p>
649<p>Added wx.GetMouseState which returns the current state of the mouse.
650It returns an instance of a wx.MouseState object that contains the
651current position of the mouse pointer in screen coordinants, as well
652as boolean values indicating the up/down status of the mouse buttons
653and the modifier keys.</p>
654<p>Added wx.SizerItem.SetUserData</p>
655<p>A variety of updates to wx.lib.floatcanvas, including Added
656DrawObjects, including a ScaledTextBox, with auto-wrapping, etc, and
657Scaled and Unscaled Bitmap Objects.</p>
658<blockquote>
659WARNING: Changed all DrawObjects to take an (x,y) pair rather
660than individual x,y parameters. Also changed rectangles and
661ellipses to take (w,h) pair. This is an API change, but should
662be easy to accommodate, all you need to do is add a parenthesis
663pair: (...x, y, ...) ---&gt; (...(x,y), ...)</blockquote>
664</div>
974a50f1 665<div class="section">
c04bcba0 666<h1><a id="id9" name="id9">2.6.1.0</a></h1>
a432a02b
RD
667<ul class="simple">
668<li>4-June-2005</li>
669</ul>
670<p>wx.ListCtrl: patch #1210352, fixes editing in generic wx.ListCtrl with
671wx.LC_EDIT_LABELS.</p>
672<p>Applied patch #208286, MediaCtrl DirectShow rewrite.</p>
673<p>DocView patches from Morgan Hua: bug fixes, and additional SVN
674commands, also added a default template that uses the text editor for
675any unknown file type.</p>
676<p>wxMSW: Use the system IDC_HAND cursor for wx.CURSOR_HAND and only fallback
677to the strange wxWidgets version if the system one is not available.</p>
678<p>wx.grid.Grid: Merge the cell size attribute the same way that other
679attributes are merged, e.g., if it is already set to a non-default
680value in the current GridCellAttr object then don't merge from the
681other.</p>
682<p>wx.lib.evtmgr: Fixed to use wx._core._wxPyDeadObject</p>
683<p>wx.lib.gridmovers: Don't scroll when the mouse is dragged outside of
684the grid, unless the mouse is kept in motion.</p>
685<p>wxMSW: Applied patch #1213290 incorrect logic in
686wx.TopLevelWindow.ShowFullScreen.</p>
687<p>Applied patch #1213066 correct device names for Joystick in Linux.</p>
688<p>wxGTK: Applied patch #1207162 wx.TextCtrl.SetStyle fix for overlapping
689calls.</p>
690<p>wx.FileConfig: fixed DeleteEntry to set the dirty flag properly so the
691change will get written at the next flush.</p>
692</div>
974a50f1 693<div class="section">
c04bcba0 694<h1><a id="id10" name="id10">2.6.0.1</a></h1>
0979bd01
RD
695<ul class="simple">
696<li>30-May-2005</li>
697</ul>
c66cd08a
RD
698<p>Added wx.BrushFromBitmap to create a stippled brush in a single step.
699Also added missing brysh style flags: wx.STIPPLE_MASK
700wx.STIPPLE_MASK_OPAQUE.</p>
6c75a4cf
RD
701<p>wxMSW: Fix for default control colours when the system text fg colour
702is not black.</p>
c66cd08a
RD
703<p>wxGTK: Patch #1171754, It is now possible to have a menu item that
704both has an icon and is a submenu.</p>
705<p>wxMSW: Patch #1197009, better refreshes when windows are moved and
706resized.</p>
707<p>wxMSW: Patch #1197468. Keeps track of pending size/position changes
708in case there is more than one adjustment for a window in a single
709DeferWindowPos set, then the pending values can be used for defaults
710instead of current values.</p>
711<p>Fixed the typemap that converts a Python list of strings to a
6c75a4cf 712wxArrayString so it uses the wxPython default encoding.</p>
c66cd08a 713<p>Several docstrings added and updated. Lots more to go.</p>
6c75a4cf
RD
714<p>wxMac: Strings added to the clipboard or used in DnD no longer have an
715extra null character at the end.</p>
716<p>Added wx.GetXDisplay that returns a raw swigified pointer for the X11
717Display, or None for the non-X11 platforms.</p>
718<p>wxMenu: Don't send an event when selecting an already selected radio
719item.</p>
720<p>Added wx.LaunchDefaultBrowser.</p>
721<p>wxMSW: Fixed erroneous selection of content in wx.ComboBox when within
722a wx.StaticBox.</p>
723<p>wxMSW: Fixed alpha blitting to take into account source position.</p>
724<p>Ensure that Python is still in an initialized state before doing any
725locking or unlocking in wxPyBeginBlockThreads and wxPyEndBlockThreads
726as these can be triggered after Python has been finalized in embedding
727situations.</p>
728<p>Added alternate constructors for wx.Font: wx.FontFromPixelSize,
729wx.FFont, wx.FFontFromPixelSize. See the docstrings or new api docs
730for details.</p>
731<p>Added wx.lib.hyperlink from Andrea Gavana. It is a control like
732static text that acts like a hyper-link, launching the system's
733default browser in response to the clicks.</p>
734<p>Added an optional parameter to wxversion.select that allows you to
735specify that the extra components specified in the version string are
736required. For example, if you ask for &quot;2.6-unicode&quot; but only the ansi
737version is installed then by default the ansi version will be selected
738as it considered close enough since the version numbers match. If you
739want to force the options to be required then you can just add a True
740parameter, like this:</p>
741<pre class="literal-block">
742import wxversion
743wxversion.select(&quot;2.6-unicode&quot;, True)
744import wx
745</pre>
746<p>Tweaked wx.lib.buttons such that flat buttons (e.g. have no bevel and
747a wx.BORDER_NONE style flag) paint themed backgrounds if there are
748transparent areas and the parent is displaying a theme.</p>
749<p>wxMSW: Fix for wrong sash colour of wx.SplitterWindow in the silver
750theme on XP.</p>
751<p>Added a wx.xrc.XmlResourceHandler for the Ticker class. See
752wx/lib/ticker_xrc.py</p>
753<p>wxSTC: Fixed CmdKeyAssign key bindings for Ctrl-Backspace.</p>
754<p>wxMSW: Fixed a bug in wx.TextCtrl where all the lines were being used
755to calculate the best size, instead of using a reasonable limit.</p>
0979bd01
RD
756<p>XRCed: Use wx.GetDefaultPyEncoding/wx.SetDefaultPyEncoding for
757changing active encoding. Fixed pasting siblings (Ctrl key pressed
758while pasting).</p>
759<p>wx.lib.filebrowsebutton: Bug fix from Chad Netzer for when
760self.history is None.</p>
761<p>wx.ogl: Patch from Davide Salomoni that adds an optional point
762parameter to LineShape.InsertLineControlPoint allowing one to
763optionally specify where the new control point has to be drawn.</p>
764<p>wxMSW: setting foreground colour for wx.CheckBox now works when using
765XP themes.</p>
766<p>More updates to the docview library modules and sample apps from the
767ActiveGrid folks. Their sample IDE is now able to integrate with
768Subversion.</p>
769<p>wx.grid.Grid: Ensure that the grid gets the focus when it is
770left-clicked. Note that if you have custom widgets that handle the
771EVT_LEFT_DOWN event but do not call event.Skip() then you will
772probably want to add a call to self.SetFocus in the event handler.</p>
773<p>wxGTK: Add wxSTAY_ON_TOP support [Patch 1206023]</p>
774<p>wx.TreeCtrl: wx.EVT_TREE_ITEM_MENU event made consistent on all
775platforms. The location of the click or the item is included in the
776event as well.</p>
777<p>wxGTK: Setting background colour of a window now only affects the
778window itself, not the borders, scrollbars, etc. (Bug #1204069)</p>
779<p>Print framework: Add more paper sizes and code to fallback to an
780explicit paper size if a known paper size is not found for the
781printer.</p>
782<p>wxMac: Applied patch for bug #1206181 Option-key decodes are wrong,
783also applied patch for bug #1205691 Modified Fn keys don't work.</p>
784<p>wx.Image: Fixed to preserve alpha channel in Rotate90 method.</p>
785<p>wxMSW: Fixed incorrect background colour on wx.CheckListBox.</p>
786<p>wxMSW: Fixed drawing of owner drawn buttons with multiline labels</p>
787<p>Removed a bunch of unnecessary files, and removed or replaced images
788that we're not sure of their origin or license.</p>
789<p>The default DoGetBestSize is updated to not always return the current
790size if the window has no sizer, children, or minsize set. Instead
791the current size is set as the minsize. This solves the occasional
792problem where a sizer may cause a childless panel to grow but never
793shrink.</p>
794<p>wxMSW: When converting a wx.Icon to a bitmap check if the icon has an
795alpha channel and set the bitmap to use it.</p>
796<p>Fixed the wrong class name used in wx.PyScrolledWindow's call to
797_setCallbackInfo.</p>
798<p>wxMSW: patch #1207202, Fixes GDI leak when using stock cursors.</p>
799<p>wx.calendar.CalendarCtrl: Patch #1207531, Keeps the CalendarCtrl wide
800enough even when the weekday names for the locale are shorter than
801usual.</p>
802<p>Made GridCellNumberEditor.StartingKey also insert the typed char when
803there is a range of allowed values (so a wx.SpinCtrl is used instead
804of a wx.TextCtrl.)</p>
c66cd08a 805</div>
974a50f1 806<div class="section">
c04bcba0 807<h1><a id="id11" name="id11">2.6.0.0</a></h1>
c66cd08a
RD
808<ul class="simple">
809<li>26-Apr-2005</li>
810</ul>
05d6c206
RD
811<p>wxMSW: Fixed wx.TransientPopupWindow (and therefore wx.TipWindow) to
812auto-dismiss when the mouse is clicked outside of the popup like it is
813supposed to.</p>
814<p>wxMSW: Fixed bug #1167891 wx.Notebook display problem with wx.NB_MULTILINE.</p>
815<p>wxMSW: Fixed bad cliping of hidden windows inside of wx.StaticBox.</p>
816<p>wxGTK: The configure flags for selecting GTK+ 1.2.x or 2.x has
817changed slightly. It is now --with-gtk[=VERSION] where VERSION is
818either '1', '2' or 'any'. The default is '2'.</p>
819<p>wx.stc.StyledTextCtrl: Added the following methods for alternate ways
820to set and fetch text from the document buffer. They work similarly
821to the existing methods of the same name, except that they don't go
822through the same string/unicode &lt;--&gt; wxString conversions. The &quot;Raw&quot;
823methods will do no conversions at all and in a unicode build of
824wxPython the strings will be in the utf-8 encoding and in an ansi
825build no assumption is made about the encoding. The &quot;UTF8&quot; functions
826will attempt to always get/set utf-8 text, which it will always be
827able to do in a unicode build, and in an ansi build it will depend on
828the content of the utf-8 used being compatible with the current
829encoding, (you'll get an exception otherwise.)</p>
830<blockquote>
c66cd08a 831<table border="1" class="docutils">
05d6c206
RD
832<colgroup>
833<col width="49%" />
834<col width="51%" />
835</colgroup>
836<tbody valign="top">
837<tr><td>AddTextRaw</td>
838<td>AddTextUTF8</td>
839</tr>
840<tr><td>InsertTextRaw</td>
841<td>InsertTextUTF8</td>
842</tr>
843<tr><td>GetCurLineRaw</td>
844<td>GetCurLineUTF8</td>
845</tr>
846<tr><td>GetLineRaw</td>
847<td>GetLineUTF8</td>
848</tr>
849<tr><td>GetSelectedTextRaw</td>
850<td>GetSelectedTextUTF8</td>
851</tr>
852<tr><td>GetTextRangeRaw</td>
853<td>GetTextRangeUTF8</td>
854</tr>
855<tr><td>SetTextRaw</td>
856<td>SetTextUTF8</td>
857</tr>
858<tr><td>GetTextRaw</td>
859<td>GetTextUTF8</td>
860</tr>
861<tr><td>AppendTextRaw</td>
862<td>AppendTextUTF8</td>
863</tr>
864</tbody>
865</table>
866</blockquote>
867<p>wx.stc.StyledTextCtrl: Added the StyleSetFontEncoding(style, enc)
868method that allows you to set the encoding to be used by the font for
869a particular style.</p>
870<p>wxMac: Fixed wx.ComboBox to forward the EVT_CHAR, EVT_KEY_DOWN,
871EVT_KEY_UP and EVT_TEXT events from its embedded text control.</p>
872<p>wxMac: Corrected refresh bugs in wxGrid.</p>
c66cd08a 873<dl class="docutils">
a8e120ce
RD
874<dt>XRCed: Updated to version 0.1.5.</dt>
875<dd><ul class="first last simple">
876<li>Added wxWizard, wxWizardPageSimple (only from pull-down menu).</li>
877<li>Hide command for test window.</li>
878<li>Replacing classes works better.</li>
879<li>Added Locate tool.</li>
880</ul>
881</dd>
882</dl>
05d6c206 883</div>
974a50f1 884<div class="section">
c04bcba0 885<h1><a id="id12" name="id12">2.5.5.1</a></h1>
c66cd08a
RD
886<ul class="simple">
887<li>8-Apr-2005</li>
888</ul>
cae92223
RD
889<p>wxMSW: Fixed bug #1022383, 'several ComboBoxes appear selected'</p>
890<p>wx.grid.Grid: Fixed bug #1163384. Moved the code that handles
891activating the cell editors to a EVT_CHAR event handler. This is done
892so the character inserted into the editor will be the &quot;cooked&quot; char
893value (including accented or composed keys) rather than the raw code
894provided by the EVT_KEY_DOWN event.</p>
895<p>Added orient parameter to wx.MDIParentFrame.Tile()</p>
896<p>wxMSW: wxTextCtrl with wx.TE_RICH2 style now uses RichEdit 4.1 if
897available.</p>
898<p>Added GetCount, GetCountRGB, and GetCountColour methods to
899wx.ImageHistogram.</p>
900<p>wxMSW: wx.Window.Refresh changed to explicitly refresh all children as
901well as the parent. Previously it was implicitly done because parents
902did not clip their children by default. Now that they always clip
903children then Refresh needed to be fixed to do a recursive refresh.
904This also fixes the Freeze/Thaw problems that some people had with
9052.5.4.1.</p>
906<p>wx.SplitterWindow: Send EVT_SPLITTER_SASH_POS_CHANGED only once after
907end of dragging and not after each CHANGING event (modified patch
908#1076226)</p>
909<p>wx.glcanvas.GLCanvas: applied patch fixing problems with X server
910crash when using nVidia cards (patch 1155132)</p>
c66cd08a 911<dl class="docutils">
cae92223
RD
912<dt>wx.lib.mixins.listctrl: Patches from Toni Brkic:</dt>
913<dd><ul class="first last simple">
914<li>Bugfix for TextEditMixin when the view can't be scrolled</li>
05d6c206 915<li>Enhancement for ListCtrlAutoWidthMixin, allowing it to manage
cae92223
RD
916the width of any column.</li>
917</ul>
918</dd>
919</dl>
920<p>wxMac: removal and reusing toolbar tools like the other platforms is
921now possible.</p>
922<p>wxMac: Correct radio tool selection after calling Realize a 2nd time.</p>
923<p>wxMSW: Applied patch #1166587, removes all flicker from wx.StaticBox</p>
924<p>Added wx.lib.foldpanelbar, Andrea Gavana's port of Jorgen Bodde's C++
925wxFoldPanelBar classes to Python.</p>
926<p>wxGTK: Applied patch #1173802, reimplementation of GtkFileChooser
927wxFileDialog by Mart Raudsepp. Note that this new file dialog is only
928used on GTK2 &gt;= 2.4. For earlier GTK2 versions and GTK1 then the
929older generic file dialog is used.</p>
930<p>wxMSW: fixes to static box borders calculations (finalizes patch
931#1166587)</p>
932<p>wx.Image: Use Python's buffer interface API for all image data and
933alpha Set/Get methods and the ImageFromData* constructors. They all
934still copy the buffer except for SetDataBuffer and SetAlphaBuffer, but
935this gives more flexibility on where the data can come from.</p>
936<p>Added MDI support to XRC</p>
937<p>Added wx.animate module and a demo. The wx.animate module provides a
938control that is able to display an animated GIF file.</p>
939<p>wx.lib.plot.py: Applied patch from Werner F. Bruhin that allows either
940vertical and/or horizontal gridlines.</p>
941<p>wxMSW: Extra space given for top border of wx.StaticBoxSizer so the
942upper line is not cliped when there is no label.</p>
943<p>wxMSW: Restored old behaviour of wx.StaticBox.SetBackgroundColour only
944affecting the label.</p>
945<p>wxMSW: Fixed missing EVT_RIGHT_DOWN and EVT_TREE_ITEM_RIGHT_CLICK
946events in a wx.TreeCtrl.</p>
947<p>Added wx.GetTopLevelWindows() function which returns a copy of the
948list of top-level windows that currently exist in the application.</p>
949<p>Updated docview library modules and sample apps from the ActiveGrid
950folks.</p>
951<p>Added the ActiveGrid IDE as a sample application.</p>
952</div>
974a50f1 953<div class="section">
c04bcba0 954<h1><a id="id13" name="id13">2.5.4.1</a></h1>
c66cd08a
RD
955<ul class="simple">
956<li>16-Mar-2005</li>
957</ul>
287cb697
RD
958<p>wx.Sizer Add, Insert, and Prepend functions now return a reference to the
959wx.SizerItem that was added to the sizer, and the wx.SizerItem has a
960GetRect accessor to give the position of the item on the parent window.</p>
961<p>Added wx.Sizer.GetItem method which returns the wx.SizerItem for the given
962wx.Window, wx.Sizer or position index.</p>
963<p>wxMSW: wx.RadioButtons in the same group no longer have to be
964consecutive (there may be intervening controls). Without this fix, an
965out-of-sync assert is generated when clicking on a radio button and
966then calling GetValue().</p>
c66cd08a 967<dl class="docutils">
05d6c206 968<dt>Some XRC changes:</dt>
287cb697
RD
969<dd><ul class="first last simple">
970<li>Added 'icon' property to wxFrame and wxDialog</li>
971<li>No longer ignores menu bitmaps on non-MSW platforms</li>
972<li>Notebook page bitmaps are now supported</li>
973<li>added system colours and fonts support (based on patch #1038207)</li>
974</ul>
975</dd>
976</dl>
977<p>wxMSW: fix for [ 1052989 ] TextCtrl.SetBackgroundColour(wx.NullColour)
978bug.</p>
979<p>Added wx.PasswordEntryDialog analagous to wx.TextEntryDialog, allows
980detecting entering an empty string vs. cancel unlike the
981wx.GetPasswordFromUser dialog function.</p>
982<p>OGL patch from Shane Holloway:</p>
983<blockquote>
984<p>Two simple problems found in the new python ogl code. First is
985the patch for _canvas.py. Essentially:</p>
986<pre class="literal-block">
987dx = abs(dc.LogicalToDeviceX(x - self._firstDragX))
988dy = abs(dc.LogicalToDeviceY(y - self._firstDragY))
989</pre>
990<p>was incorrect because (x,y) and (self._firstDragX,
991self._firstDragY) are both already in Logical coordinates.
992Therefore the difference between the two is also in logical
993coordinates, and the conversion call is an error. This bug
994surfaces when you have OGL on a scrollwin, and you are far from
995the origin of the canvas.</p>
996<p>The second change in _composit.py basically removes the assumption
997that the child is in both self._children and self._divisions.
998Causes many problems when it's not. ;)</p>
999</blockquote>
1000<p>Fixed GetSaveData and SetSaveData in wx.lib.multisash to not depend on
1001the default way that class objectss are converted to strings.</p>
1002<p>Fixed problem in StyledTextCtrl.Set[HV]ScrollBar that could leave the
1003internal scrollbar visible.</p>
1004<p>Added wx.StandardPaths which provides methods for determining standard
1005system paths for each platform.</p>
1006<p>wxMSW: The window background is now only erased by default if the
1007background colour or background mode has been changed. This better
1008allows the default system themed behaviour to show through for
1009uncustomized windows. Explicit support added for using the correct
1010theme texture for wx.Notebook pages and their children.</p>
1011<p>wx.Image: Added support for alpha channels in interpolated and
1012non-interpolated image rotation. Added ConvertAlphaToMask helper
1013method for turning shades of grey into shades of alpha and a colour.</p>
1014<p>wxGTK2: Reimplemented DoDrawRotatedText() by way of a rotation of an
1015alpha blended text bitmap. It would be better if Pango could draw
1016directly into an wxImage (as FreeType can,) but that is for later...</p>
1017<p>Added wrappers and a demo for the wx.MediaCtrl class, which can play
1018various forms of audio/video media using native codecs install on the
1019system. So far it is only implemented for Windows and OSX.</p>
1020<p>wxGTK: Patch applied for Freeze()/Thaw() for wxTextCtrtl.</p>
1021<p>Added &quot;gravity&quot; for splitter window (patch 1046105). Gravity is a
1022floating-point factor between 0.0 and 1.0 which controls position of
1023sash while resizing the wx.SplitterWindow. The gravity specifies
1024how much the left/top window will grow while resizing.</p>
1025<p>wxMSW: wx.Slider's C++ implementation rewritten to be more
1026maintainable and hopefully less buggy. The position of the labels has
1027also been changed in order to better comply with Microsoft's examples
1028of how to use the control.</p>
1029<p>wxMSW: Fix wx.TreeCtrl to end label editing if the control loses
1030focus (a slightly modified patch 1084592.)</p>
1031<p>Added wx.EXEC_NODISABLE flag for wx.Execute, which will prevent all
1032the app's windows being disabled while a synchronous child process is
1033running.</p>
1034<p>wxMSW: Much work to correct painting (or leaving transparent) of
1035control backgrounds, properly using background themes on XP, etc.</p>
1036<p>Fixed a circular reference problem with wx.Timer. It will now
1037completely cleanup after itself when the last reference to the timer
1038is removed. If you were previously using timer.Destroy() to cleanup
1039your timers it will no longer work. Instead you should hold a
1040reference to the timer and then del the reference when you are
1041finished with the timer.</p>
1042<p>Updated to 1.3.24 of SWIG. All of my big patches have been applied to
1043the main SWIG source tree, but unfortunatly there were also some bugs
1044added that affected the wxPython build and a few details in my
1045original patch were changed/removed, so we are still not free of
1046patches. A new patch for SWIG is located in the wxPython/SWIG
1047directory of the wxPython source tree. SWIG 1.3.24 plus this patch
1048should be used by anyone who is making custom modifications to
1049wxPython's .i files, or building their own extension modules or
1050etc. that need to interact with the wxPython swigged types. For the
1051morbidly curious, here are a few more details:</p>
1052<blockquote>
1053<ul class="simple">
1054<li>Since it is now possible easily and simply share the SWIG type
1055tables across modules I reverted to always using the stock SWIG
1056runtime instead of my slightly hacked up version of it exported
1057via the wxPython C API.</li>
1058<li>The %name directive is now deprecated so I replaced most uses of
1059it with a custom %Rename macro that uses %rename internally.
1060These will evetually need to be replaced with a DocDecl macro
1061when docstrings are added for those items.</li>
1062<li>The &quot;this&quot; attribute of all SWIGged classes is no longer a
1063string containing a &quot;swigified pointer&quot;, but rather a custom
1064built-in type that holds the real C pointer to the object and
1065the type info. It can be converted to a string like the old
1066value using str() or to the long integer value of the pointer
1067using long().</li>
1068</ul>
1069</blockquote>
1070<p>Added SetDefaultPyEncoding and GetDefaultPyEncoding functions which
1071will set/get the encoding used by wxPython to convert string or
1072unicode objects to/from wxString objects. Previously the default
1073Python encoding was always used, but unless the user had tweaked their
1074sitecustomize.py file it is always &quot;ascii&quot;, which would result in
1075errors if the strings contained character codes &gt;= 128.
1076SetDefaultPyEncoding will now allow you to control which encoding will
1077be used to do those conversions. The default encoding is set to the
1078value of <cite>locale.getdefaultlocale()[1]</cite> when wxPython is first
1079imported. Please see <a class="reference" href="http://www.alanwood.net/demos/charsetdiffs.html">http://www.alanwood.net/demos/charsetdiffs.html</a>
1080for information on the differences between the common latin/roman
1081encodings.</p>
1082<p>Added wxStdDialogButtonSizer, which is a a special sizer that knows
1083how to order and position standard buttons in order to conform to the
1084current platform's standards. You simply need to add each <cite>wx.Button</cite>
1085to the sizer, and be sure to create the buttons using the standard
1086ID's. Then call <cite>Realize</cite> and the sizer will take care of the rest.</p>
1087<p>wxMSW Toolbar: pass correct tool id (and not always -1) to the
1088EVT_TOOL_RCLICKED handler</p>
1089<p>wxGTK: Applied patch for combo box SELECTED events (no longer get
1090lots of surplus events)</p>
1091<p>wxGTK: Applied patch for proper menu highlight colour detection in
1092wx.SystemSettings.</p>
1093<p>wxGTK: Commited scrollbar patch #1093339 which sends lineup, linedown
1094events based on intercepting the mouse down events.</p>
1095<p>wxGTK: Applied patch #1102789 which solved conflicts between wxWidgets
1096and GTK+'s context menu code.</p>
1097<p>wxGTK: Applied patch #1100327 for correct feedback from DND actions
1098(not all actions are allowed).</p>
1099<p>Fixed memory leak in wxGrid::UpdateAttr[Rows][Or][Cols] (patch 1104355)</p>
1100<p>For efficiency reasons, text controls no longer set the string for
1101each text updated event, but rather query for the string value only
1102when GetString is called from an event handler.</p>
1103<p>Added wx.SL_INVERSE style which will cause wx.Slider to invert the min
1104and max ends of the slider.</p>
1105<p>Several patches applied, such as #1111174, #1110252 and others, that
1106make the generic wx.TreeCtrl (used on wxGTK and wxMac) be more
1107conistent with the wxMSW native wx.TreeCtrl.</p>
c66cd08a 1108<dl class="docutils">
287cb697
RD
1109<dt>XRCed:</dt>
1110<dd><ul class="first last simple">
1111<li>Edit-&gt;Locate command (Ctrl-L) for quick selection of items.
1112Works with event-handling controls (buttons, text fields) but
1113not with labels/sizers.</li>
1114<li>Some improvements: relative paths for files supplied as command-
1115line argument work correctly, notebook panels are highlighted
1116better.</li>
1117</ul>
1118</dd>
1119</dl>
1120<p>wxMac: Fixed a long-standing issue where wxSlider controls with a
1121hardcoded size would misplace their labels behind the slider control.</p>
1122<p>wx.HtmlListBox fixed so calling RefreshLine(s) will cause the data for
1123that line to be refetched from the overridden methods in the derived
1124class.</p>
1125<p>The default DoGetBestSize now includes the difference (if any) between
1126the client size and total size of the window, (such as the size of
1127borders.) Code that sets the client size using the best size, or that
1128added extra space to sizers to compensate for this bug may need to be
1129changed.</p>
1130<p>Can suppress themed notebook pages with the wxNB_NOPAGETHEME style or
1131setting system option msw.notebook.themed-background to 0.</p>
1132<p>wxSyledTextCtrl updated to use Scintilla 1.62.</p>
1133<p>Can now set the msw.window.no-clip-children system option to 1 to
1134eliminate weird refresh behaviour (delays between a window being
1135erased and repainted, giving a ghostly gradual-redraw effect). May be
1136a temporary 'fix' until properly fixed before 2.6.</p>
1137<p>wxMac: Toolbar is now more native looking with borderless toolbar
1138buttons.</p>
1139<p>wxMac: Switched wx.Bitmap to use newer Quartz object types and APIs
1140internally. This results in faster display and better alpha support.</p>
1141<p>Added wx.DatePickerCtrl.</p>
1142<p>wx.html.HtmlWindow now supports background images.</p>
1143<p>Added wx.lib.gestures module from Daniel Pozmanter which supports
1144using Mouse Gestures in an application.</p>
1145<p>wxGTK2: ENTER and LEAVE mouse events are now sent for multi-line text
1146controls.</p>
1147<p>wxMSW: &quot;Alt&quot; key (VK_MENU) now results in WXK_ALT keyboard event, not
1148WXK_MENU</p>
1149<p>Added modules from Peter Yared and Morgan Hua that implement the wx
1150Doc/View framework in pure Python code. See wx.lib.docview for the
1151base implementation and wx.lib.pydocview for Python-specific
1152extensions. There are also a couple sample applications located in
1153samples/docview.</p>
1154<p>Added GetBitmap, GetIcon to wx.ImageList.</p>
1155<p>wxGTK wx.Button.SetLabel no longer invalidates/resets the font.</p>
1156<p>wx.Sizer.AddWindow, AddSizer, AddSpacer and etc. have now been
1157undeprecated at the request of Riaan Booysen, the Boa Constructor team
1158lead. Boa needs them to help keep track of what kind of item is being
1159managed by the sizer. They are now just simple compatibility aliases
1160for Add, and etc.</p>
1161<p>The old C++ version of the OGL lib is no longer built by default. Use
1162the Python version in the wx.lib.ogl package instead.</p>
1163<p>The wx.iewin module is no longer built by default. You can use the
1164wx.lib.iewin version instead.</p>
1165<p>Fixed wx.BufferedPaintDC for scrolled windows to work whether the
1166buffer is covering only the client area or the full virtual area of
1167the scrolled window. By default it will assume that only the client
1168area is covered. This is different than the old behavior so to
1169indicate that the entire virtual area is covered simply add a
1170style=wx.BUFFER_VIRTUAL_AREA parameter.</p>
1171<p>wx.gizmos.TreeListCtrl: Add support for the EVT_TREE_ITEM_GETTOOLTIP
1172event.</p>
1173<p>Added Resize, SetRGBRect, Size, and GetOrFindMaskColour methods to
1174wx.Image.</p>
1175<p>Added wx.Rect.IsEmpty</p>
c66cd08a 1176<dl class="docutils">
287cb697
RD
1177<dt>wxGTK:</dt>
1178<dd><ul class="first last simple">
1179<li>Corrected wx.ListBox selection handling</li>
1180<li>Corrected default button size handling for different themes</li>
1181<li>Corrected splitter sash size and look for different themes</li>
1182<li>Fixed keyboard input for dead-keys</li>
1183</ul>
1184</dd>
1185</dl>
1186</div>
974a50f1 1187<div class="section">
c04bcba0 1188<h1><a id="id14" name="id14">2.5.3.1</a></h1>
c66cd08a
RD
1189<ul class="simple">
1190<li>9-Nov-2004</li>
1191</ul>
60b517c1
RD
1192<p>wxMac focus and border refreshes corrected.</p>
1193<p>Updated internal PNG library.</p>
1194<p>wxMac fix for metal appearance on wx.ToolBar.</p>
1195<p>wx.grid.Grid fix allowing DoGetBestSize to be called before CreateGrid
1196(which means that a min size doesn't need to be specified.)</p>
1197<p>wxMac fix for not sending a native click to a control if it is not
1198enabled (does an enable itself)</p>
1199<p>Added wx.lib.ogl.DrawnShape, and fixed various little bugs in the new
1200OGL.</p>
1201<p>Added support to XRC and XRCed for the 3-state checkbox flags and also
1202for wx.ToggleButton. Updated the generic window styles supported by
1203XRCed.</p>
1204<p>It is now possible to create &quot;stock&quot; buttons. Basically this means
1205that you only have to provide one of the stock IDs (and either an
1206empty label or a label that matches the stock label) when creating the
1207button and wxWidgets will choose the stock label to go with it
1208automatically. Additionally on the platforms that have a native
1209concept of a stock button (currently only GTK2) then the native stock
1210button will be used. For example, the following will result in a
287cb697
RD
1211button with &quot;Cancel&quot; as the label and if run on wxGTK2 then there will
1212also be an image of a red X:</p>
60b517c1 1213<pre class="literal-block">
05d6c206 1214b = wx.Button(parent, wx.ID_CANCEL)
60b517c1
RD
1215</pre>
1216<p>Added wx.lib.ticker.Ticker class from Chris Mellon.</p>
1217<p>Fix some incorrect clipping regions in wxSTC on wxGTK.</p>
1218<p>Added wrapper for wx.grid.Grid.GetOrCreateCellAttr.</p>
1219<p>Removed my copy of distutils from the wxPython source tree. Now that
1220I am no longer doing builds on Python 2.1 the newest distutils is no
1221longer needed. (There is still one small bug in Python 2.2 distutils
1222on win32, but it is easily worked around.) This sovles the problem of
1223incorrect builds on some systems where the system installed distutils
1224has been patched to behave slightly differently, for example SuSE on
1225x86_64 or Chandler's build.</p>
1226<p>Updated to SWIG 1.3.22 (plus my patch.) See wxPython/SWIG/README.txt
1227in the source tree if you need to use SWIG when building your own copy
1228of wxPython, or other extension modules that need to integrate with
1229the wxPython modules.</p>
1230<p>Added wx.Frame.RequestUserAttention which, if the platform suports it,
1231will do something (such as flash the task bar item) to suggest to the
1232user that they should look at that window.</p>
1233<p>&quot;Fixed&quot; wx.grid.Grid.SetDefaultEditor and SetDefaultRenderer by making
1234them register the editor or renderer for the &quot;string&quot; data type.</p>
1235<p>Added depth param to wx.Image.ConvertToBitmap.</p>
1236<p>Extended the wx.calendar.CalendarCtrl class with methods that get/set
1237a Python datetime or date object. (These will only work with Python
12382.3+) The methods are PySetDate, PyGetDate, PySetLowerDateLimit,
1239PySetUpperDateLimit, PySetDateRange, PyGetLowerDateLimit, and
1240PyGetUpperDateLimit. Also, CalendarEvent was extended with PySetDate
1241and PyGetDate methods.</p>
1242<p>wxMSW: SetBackgroundColour on a wx.Choice or a wx.ComboBox will now
1243also set the colour of the dropdown.</p>
1244<p>wxMac: MessageDialog now supports wx.NO_DEFAULT style</p>
1245<p>wxMSW: added AssociateHandle and DissociateHandle to wx.Window</p>
1246<p>wxMac: fix for toolbar tooltips</p>
1247<p>wx.Sizer.Show (and Hide) now take an optional parameter specifying if
1248the item to be shown should be searched for recursivly in subsizers,
1249and return a boolean value indicating if the item was found.</p>
1250<p>wxMSW: fixed MaximizeEvent generation in wx.Frame</p>
1251<p>wxMSW: fixed sending duplicate EVT_COMBOBOX events</p>
1252<p>Smoother time estimation updates in wx.ProgressDialog (patch 992813)</p>
1253<p>Made wx.Listbook events more consistent with wx.Notebook ones (patch
12541001271)</p>
1255<p>Fixed rounding errors in variable status bar panes widths computation
1256(patch 1030021)</p>
1257<p>Added possibility to specify printer bin (patch 910272)</p>
1258<p>wxMSW: fixed wx.ListCtrl's SetWindowStyleFlag() to not remove
1259WS_VISIBLE; also refresh the control automatically (closes bug
12601019440)</p>
1261<p>Added wx.Choicebook, yet another notebook-like control.</p>
1262<p>wxMSW: Make radiobutton tab behaviour the same on MSW as in standard
1263MSW app, i.e. tab into the activated, not necessarily the first radio
1264button.</p>
1265<p>Added limited support for wxEventLoop (you can't derive from a
1266wx.PyEventLoop version yet...) Updated and moved the sample showing
1267how to replace the MainLoop to samples/mainloop/mainloop.py.</p>
1268<p>The C++ xrc lib has been moved out of contrib and into the core, so it
1269is always built by default. wxPython's build has also changed
1270accordingly and will build the xrc module as part of the core set of
1271modules built by default. If you were axplicitly using BUILD_XRC then
1272it will no longer be recognized as a build option, otherwise you
1273should notice no difference.</p>
1274<p>wxMac: Fixed radio toolbar buttons to correctly untoggle the others
1275when a new one is selected.</p>
1276<p>wxMac: Fixed GetLineLength and GetLineText for MLTE text controls</p>
1277<p>wxMac: wx.TaskBarIcon is implemented by allowing you to change the
1278app's icon on the Dock and also specifying a menu that should be
1279merged with the normal dock popup menu. See the MigrationGuide for
1280more details and a warning.</p>
1281<p>Added wx.TopLevelWindow.IsActive() which tells you if the frame or
1282dialog is or containts the active window with the keyboard focus.</p>
1283<p>Added ability to create a font based on pixel size rather than point
1284size via the FontFromPixelSize constructor.</p>
1285<p>Updated the Scintilla used by StyledTextCtrl to version 1.61</p>
1286<p>Improved image HitTest for TreeListCtrl.</p>
1287<p>Added wx.App.IsMainLoopRunning.</p>
1288<p>wxGTK: Make wxComboBox spit out a bit fewer surplus events when
1289holding down the mouse button.</p>
1290<p>wxGTK: Enable key based navigation through notebook tabs as in the
1291native control with Left and right keys. Support for vetoing.</p>
1292<p>FloatCanvas updates from Chris Barker</p>
c66cd08a 1293<dl class="docutils">
60b517c1
RD
1294<dt>PyPlot updates from Gordon Williams:</dt>
1295<dd><ul class="first last simple">
1296<li>Added bar graph demo</li>
1297<li>Modified line end shape from round to square.</li>
1298<li>Removed FloatDCWrapper for conversion to ints and ints in
1299arguments</li>
1300<li>Imported modules given leading underscore to name.</li>
1301<li>Added Cursor Line Tracking and User Point Labels.</li>
1302<li>Demo for Cursor Line Tracking and Point Labels.</li>
1303<li>Size of plot preview frame adjusted to show page better.</li>
1304<li>Added helper functions PositionUserToScreen and
1305PositionScreenToUser in PlotCanvas.</li>
1306<li>Added functions GetClosestPoints (all curves) and GetClosestPoint
1307(only closest curve) can be in either user coords or screen
1308coords.</li>
1309</ul>
1310</dd>
1311<dt>MaskedEdit updates from Will Sadkin:</dt>
1312<dd><ul class="first last simple">
1313<li>Added '*' mask char that means &quot;all ansii chars&quot; (ords 32-255)</li>
1314<li>Added proper unicode support to masked controls and wx.tools.dbg</li>
1315<li>Fixed two reported missing import bugs introduced by package
1316creation</li>
1317<li>Converted masked package doc strings to reST format for better
1318epydoc support</li>
1319<li>lots of doc string improvements and function hiding to better
1320reflect package's public contents.</li>
1321</ul>
1322</dd>
1323</dl>
1324<p>Restructured the installer packages slightly to help facilitate having
1325multiple versions of wxPython installed at the same time. See the
1326Migrarion Guide for more information.</p>
c66cd08a 1327<dl class="docutils">
60b517c1
RD
1328<dt>Applied patch from Pim Van Heuven that modifies 4 files:</dt>
1329<dd><ul class="first last simple">
1330<li>wxPython/demo/ListCtrl_edit.py (new demo)</li>
1331<li>wxPython/demo/Main.py (include new demo in demo app)</li>
05d6c206 1332<li>wxPython/wx/lib/mixins/listctrl.py (several improvements to
60b517c1
RD
1333TextEditMixin)</li>
1334<li>wxPython/wx/lib/wxpTag.py (some small fixes)</li>
1335</ul>
1336</dd>
1337</dl>
1338<p>Added (thanks to Kevin Ollivier!) wrappers for wx.WebKitCtrl for the
1339OSX build. Other platforms will raise an exception if you try to use
1340it.</p>
1341<p>wxPython on OSX can now be built in Unicode mode, can support multiple
1342version installs, and comes with an uninstaller script.</p>
1343</div>
974a50f1 1344<div class="section">
c04bcba0 1345<h1><a id="id15" name="id15">2.5.2.8</a></h1>
c66cd08a
RD
1346<ul class="simple">
1347<li>27-Aug-2004</li>
1348</ul>
df1a2934
RD
1349<p>Predominantly a bug-fix release.</p>
1350<blockquote>
1351<ul class="simple">
1352<li>Fixed fatal error due to improper wrapping of wx.FSFile.</li>
1353<li>Fixed return type of EditableListBox.GetListCtrl</li>
1354<li>Give generic tree and list controls a DoGetBestSize so they play
1355nicer with sizers when there is no minimal size.</li>
1356<li>Some tweaks in the demo and samples to correct layout, some
1357flicker problems, and namespace use.</li>
1358<li>Add wx.Image.ConvertAlphaToMask</li>
1359<li>Minor corrections in wx.lib.dialogs</li>
1360<li>wx.FileHistory constructor now accepts the documented 2nd
1361parameter.</li>
1362<li>Corrections for exceptions in the new ogl</li>
1363<li>Fixed XRCed to not use reparenting of windows to implement caching
1364of property panels, since Reparent on wxMac is not implemented.</li>
1365<li>Add support for wxTAB_TRAVERSAL to the XRC handler for
1366wxScrolledWindow.</li>
1367<li>Add support for all wxListBox styles to the XRC handler for
1368wxCheckListBox.</li>
1369<li>Fix for wx.Listbook.DeleteAllPages to really delete everything.</li>
1370<li>wxGTK2 now supports alpha blended bitmap drawing</li>
1371<li>Made wx.grid.Grid play nicer with sizers.</li>
1372<li>etc.</li>
1373</ul>
1374</blockquote>
1375</div>
974a50f1 1376<div class="section">
c04bcba0 1377<h1><a id="id16" name="id16">2.5.2.7</a></h1>
c66cd08a
RD
1378<ul class="simple">
1379<li>14-Aug-2004</li>
1380</ul>
40efbdda
RD
1381<p>wx.ADJUST_MINSIZE is now the default behaviour for window items in
1382sizers. This means that the item's GetMinSize and/or GetBestSize will
1383be called when calculating layout and the return value from that will
1384be used for the minimum size used by the sizer. The wx.FIXED_MINSIZE
1385flag was added that will cause the sizer to use the old behaviour in
1386that it will <em>not</em> call the window's methods to determine the new best
1387size, instead the minsize that the window had when added to the sizer
da2c7672
RD
1388(or the size the window was created with) will always be used. Please
1389see the Sizers section in the Migration Guide for more details.</p>
40efbdda
RD
1390<p>Added new MaskedEditControl code from Will Sadkin. The modules are
1391now locaed in their own sub-package, wx.lib.masked. Demos updated.</p>
1392<p>The changes that implemented the incompatible wx.DC methods in 2.5.1.5
1393have been reverted. The wx.DC methods are now compatible with the 2.4
1394implemetation. In addition a set of renamed methods have been added
1395that take wx.Point and/or wx.Size objects instead of individual
1396parameters.</p>
1397<p>Added wx.lib.mixins.listctrl.TextEditMixin, a mixin class that allows
1398all columns of a wx.ListCtrl in report mode to be edited.</p>
1399<p>Deprecated the wx.iewin module.</p>
1400<p>Deprecated the wx.Sizer.AddWindow, AddSizer, AddSpacer methods as well
1401as their Insert* and Prepend* counterparts.</p>
1402<p>Added a generic StaticBitmap class in wx.lib.statbmp for the same
1403reasons that stattext was created, so it could be mouse sensitive on
1404all platforms like normal windows. Also updated stattext.py and
1405buttons.py to handle attribute (font &amp; colour) defaults and
1406inheritance the new way. If you have custom controls of your own you
1407should review stattxt.py or one of the others to see how it is to be
1408done.</p>
1409<p>wx.InitAllImageHandlers is now an empty function that does nothing but
1410exist for backwards compatibility. The C++ version is now called
1411automatically when wxPython is initialized. Since all the handlers
1412are included in the wxWidgets shared library anyway, this imposes only
1413a very small amount of overhead and removes several unneccessary
1414problems.</p>
1415<p>Replaced wx/lib/pubsub.py with a version that uses weak references to
1416track the subscribers, plus other fixes/additions. Thanks go to
1417Oliver Schoenborn and Robb Shecter.</p>
1418<p>wxGTK now uses gtk_init_check so wxPython can raise an exception if
1419there is no DISPLAY available or other initializaion problem.</p>
1420<p>wx.GetKeyState now has an implementation for wxGTK and is able to
1421detect the up/down or toggle state of modifier and toggle keys.</p>
1422<p>The LC_NUMERIC locale is now reset back to &quot;C&quot; (compatibility) when
1423running on wxGTK to work around the fact that GTK requires the locale
1424to be set to the system settings but Python depends on LC_NUMERIC
1425remaining compatible with &quot;C&quot;.</p>
1426<p>Switched gizmos.TreeListCtrl to the newer version of the code from the
1427wxCode project.</p>
1428<p>OGL is dead! LONG LIVE OGL! (Oops, sorry. A bit of my dramatic side
1429leaked out there...) The wx.ogl module has been deprecated in favor
1430of the new Python port of the OGL library located at wx.lib.ogl
1431