]> git.saurik.com Git - wxWidgets.git/blame_incremental - wxPython/docs/CHANGES.html
'[1219035] cleanup: miscellaneous' and minor source cleaning.
[wxWidgets.git] / wxPython / docs / CHANGES.html
... / ...
CommitLineData
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" />
6<meta name="generator" content="Docutils 0.3.7: http://docutils.sourceforge.net/" />
7<title>Recent Changes for wxPython</title>
8<link rel="stylesheet" href="default.css" type="text/css" />
9</head>
10<body>
11<div class="document" id="recent-changes-for-wxpython">
12<h1 class="title">Recent Changes for wxPython</h1>
13<div class="section" id="id1">
14<h1><a name="id1">2.6.1.0</a></h1>
15<ul class="simple">
16<li>4-June-2005</li>
17</ul>
18<p>wx.ListCtrl: patch #1210352, fixes editing in generic wx.ListCtrl with
19wx.LC_EDIT_LABELS.</p>
20<p>Applied patch #208286, MediaCtrl DirectShow rewrite.</p>
21<p>DocView patches from Morgan Hua: bug fixes, and additional SVN
22commands, also added a default template that uses the text editor for
23any unknown file type.</p>
24<p>wxMSW: Use the system IDC_HAND cursor for wx.CURSOR_HAND and only fallback
25to the strange wxWidgets version if the system one is not available.</p>
26<p>wx.grid.Grid: Merge the cell size attribute the same way that other
27attributes are merged, e.g., if it is already set to a non-default
28value in the current GridCellAttr object then don't merge from the
29other.</p>
30<p>wx.lib.evtmgr: Fixed to use wx._core._wxPyDeadObject</p>
31<p>wx.lib.gridmovers: Don't scroll when the mouse is dragged outside of
32the grid, unless the mouse is kept in motion.</p>
33<p>wxMSW: Applied patch #1213290 incorrect logic in
34wx.TopLevelWindow.ShowFullScreen.</p>
35<p>Applied patch #1213066 correct device names for Joystick in Linux.</p>
36<p>wxGTK: Applied patch #1207162 wx.TextCtrl.SetStyle fix for overlapping
37calls.</p>
38<p>wx.FileConfig: fixed DeleteEntry to set the dirty flag properly so the
39change will get written at the next flush.</p>
40</div>
41<div class="section" id="id2">
42<h1><a name="id2">2.6.0.1</a></h1>
43<ul class="simple">
44<li>30-May-2005</li>
45</ul>
46<p>Added wx.BrushFromBitmap to create a stippled brush in a single step.
47Also added missing brysh style flags: wx.STIPPLE_MASK
48wx.STIPPLE_MASK_OPAQUE.</p>
49<p>wxMSW: Fix for default control colours when the system text fg colour
50is not black.</p>
51<p>wxGTK: Patch #1171754, It is now possible to have a menu item that
52both has an icon and is a submenu.</p>
53<p>wxMSW: Patch #1197009, better refreshes when windows are moved and
54resized.</p>
55<p>wxMSW: Patch #1197468. Keeps track of pending size/position changes
56in case there is more than one adjustment for a window in a single
57DeferWindowPos set, then the pending values can be used for defaults
58instead of current values.</p>
59<p>Fixed the typemap that converts a Python list of strings to a
60wxArrayString so it uses the wxPython default encoding.</p>
61<p>Several docstrings added and updated. Lots more to go.</p>
62<p>wxMac: Strings added to the clipboard or used in DnD no longer have an
63extra null character at the end.</p>
64<p>Added wx.GetXDisplay that returns a raw swigified pointer for the X11
65Display, or None for the non-X11 platforms.</p>
66<p>wxMenu: Don't send an event when selecting an already selected radio
67item.</p>
68<p>Added wx.LaunchDefaultBrowser.</p>
69<p>wxMSW: Fixed erroneous selection of content in wx.ComboBox when within
70a wx.StaticBox.</p>
71<p>wxMSW: Fixed alpha blitting to take into account source position.</p>
72<p>Ensure that Python is still in an initialized state before doing any
73locking or unlocking in wxPyBeginBlockThreads and wxPyEndBlockThreads
74as these can be triggered after Python has been finalized in embedding
75situations.</p>
76<p>Added alternate constructors for wx.Font: wx.FontFromPixelSize,
77wx.FFont, wx.FFontFromPixelSize. See the docstrings or new api docs
78for details.</p>
79<p>Added wx.lib.hyperlink from Andrea Gavana. It is a control like
80static text that acts like a hyper-link, launching the system's
81default browser in response to the clicks.</p>
82<p>Added an optional parameter to wxversion.select that allows you to
83specify that the extra components specified in the version string are
84required. For example, if you ask for &quot;2.6-unicode&quot; but only the ansi
85version is installed then by default the ansi version will be selected
86as it considered close enough since the version numbers match. If you
87want to force the options to be required then you can just add a True
88parameter, like this:</p>
89<pre class="literal-block">
90import wxversion
91wxversion.select(&quot;2.6-unicode&quot;, True)
92import wx
93</pre>
94<p>Tweaked wx.lib.buttons such that flat buttons (e.g. have no bevel and
95a wx.BORDER_NONE style flag) paint themed backgrounds if there are
96transparent areas and the parent is displaying a theme.</p>
97<p>wxMSW: Fix for wrong sash colour of wx.SplitterWindow in the silver
98theme on XP.</p>
99<p>Added a wx.xrc.XmlResourceHandler for the Ticker class. See
100wx/lib/ticker_xrc.py</p>
101<p>wxSTC: Fixed CmdKeyAssign key bindings for Ctrl-Backspace.</p>
102<p>wxMSW: Fixed a bug in wx.TextCtrl where all the lines were being used
103to calculate the best size, instead of using a reasonable limit.</p>
104<p>XRCed: Use wx.GetDefaultPyEncoding/wx.SetDefaultPyEncoding for
105changing active encoding. Fixed pasting siblings (Ctrl key pressed
106while pasting).</p>
107<p>wx.lib.filebrowsebutton: Bug fix from Chad Netzer for when
108self.history is None.</p>
109<p>wx.ogl: Patch from Davide Salomoni that adds an optional point
110parameter to LineShape.InsertLineControlPoint allowing one to
111optionally specify where the new control point has to be drawn.</p>
112<p>wxMSW: setting foreground colour for wx.CheckBox now works when using
113XP themes.</p>
114<p>More updates to the docview library modules and sample apps from the
115ActiveGrid folks. Their sample IDE is now able to integrate with
116Subversion.</p>
117<p>wx.grid.Grid: Ensure that the grid gets the focus when it is
118left-clicked. Note that if you have custom widgets that handle the
119EVT_LEFT_DOWN event but do not call event.Skip() then you will
120probably want to add a call to self.SetFocus in the event handler.</p>
121<p>wxGTK: Add wxSTAY_ON_TOP support [Patch 1206023]</p>
122<p>wx.TreeCtrl: wx.EVT_TREE_ITEM_MENU event made consistent on all
123platforms. The location of the click or the item is included in the
124event as well.</p>
125<p>wxGTK: Setting background colour of a window now only affects the
126window itself, not the borders, scrollbars, etc. (Bug #1204069)</p>
127<p>Print framework: Add more paper sizes and code to fallback to an
128explicit paper size if a known paper size is not found for the
129printer.</p>
130<p>wxMac: Applied patch for bug #1206181 Option-key decodes are wrong,
131also applied patch for bug #1205691 Modified Fn keys don't work.</p>
132<p>wx.Image: Fixed to preserve alpha channel in Rotate90 method.</p>
133<p>wxMSW: Fixed incorrect background colour on wx.CheckListBox.</p>
134<p>wxMSW: Fixed drawing of owner drawn buttons with multiline labels</p>
135<p>Removed a bunch of unnecessary files, and removed or replaced images
136that we're not sure of their origin or license.</p>
137<p>The default DoGetBestSize is updated to not always return the current
138size if the window has no sizer, children, or minsize set. Instead
139the current size is set as the minsize. This solves the occasional
140problem where a sizer may cause a childless panel to grow but never
141shrink.</p>
142<p>wxMSW: When converting a wx.Icon to a bitmap check if the icon has an
143alpha channel and set the bitmap to use it.</p>
144<p>Fixed the wrong class name used in wx.PyScrolledWindow's call to
145_setCallbackInfo.</p>
146<p>wxMSW: patch #1207202, Fixes GDI leak when using stock cursors.</p>
147<p>wx.calendar.CalendarCtrl: Patch #1207531, Keeps the CalendarCtrl wide
148enough even when the weekday names for the locale are shorter than
149usual.</p>
150<p>Made GridCellNumberEditor.StartingKey also insert the typed char when
151there is a range of allowed values (so a wx.SpinCtrl is used instead
152of a wx.TextCtrl.)</p>
153</div>
154<div class="section" id="id3">
155<h1><a name="id3">2.6.0.0</a></h1>
156<ul class="simple">
157<li>26-Apr-2005</li>
158</ul>
159<p>wxMSW: Fixed wx.TransientPopupWindow (and therefore wx.TipWindow) to
160auto-dismiss when the mouse is clicked outside of the popup like it is
161supposed to.</p>
162<p>wxMSW: Fixed bug #1167891 wx.Notebook display problem with wx.NB_MULTILINE.</p>
163<p>wxMSW: Fixed bad cliping of hidden windows inside of wx.StaticBox.</p>
164<p>wxGTK: The configure flags for selecting GTK+ 1.2.x or 2.x has
165changed slightly. It is now --with-gtk[=VERSION] where VERSION is
166either '1', '2' or 'any'. The default is '2'.</p>
167<p>wx.stc.StyledTextCtrl: Added the following methods for alternate ways
168to set and fetch text from the document buffer. They work similarly
169to the existing methods of the same name, except that they don't go
170through the same string/unicode &lt;--&gt; wxString conversions. The &quot;Raw&quot;
171methods will do no conversions at all and in a unicode build of
172wxPython the strings will be in the utf-8 encoding and in an ansi
173build no assumption is made about the encoding. The &quot;UTF8&quot; functions
174will attempt to always get/set utf-8 text, which it will always be
175able to do in a unicode build, and in an ansi build it will depend on
176the content of the utf-8 used being compatible with the current
177encoding, (you'll get an exception otherwise.)</p>
178<blockquote>
179<table border="1" class="docutils">
180<colgroup>
181<col width="49%" />
182<col width="51%" />
183</colgroup>
184<tbody valign="top">
185<tr><td>AddTextRaw</td>
186<td>AddTextUTF8</td>
187</tr>
188<tr><td>InsertTextRaw</td>
189<td>InsertTextUTF8</td>
190</tr>
191<tr><td>GetCurLineRaw</td>
192<td>GetCurLineUTF8</td>
193</tr>
194<tr><td>GetLineRaw</td>
195<td>GetLineUTF8</td>
196</tr>
197<tr><td>GetSelectedTextRaw</td>
198<td>GetSelectedTextUTF8</td>
199</tr>
200<tr><td>GetTextRangeRaw</td>
201<td>GetTextRangeUTF8</td>
202</tr>
203<tr><td>SetTextRaw</td>
204<td>SetTextUTF8</td>
205</tr>
206<tr><td>GetTextRaw</td>
207<td>GetTextUTF8</td>
208</tr>
209<tr><td>AppendTextRaw</td>
210<td>AppendTextUTF8</td>
211</tr>
212</tbody>
213</table>
214</blockquote>
215<p>wx.stc.StyledTextCtrl: Added the StyleSetFontEncoding(style, enc)
216method that allows you to set the encoding to be used by the font for
217a particular style.</p>
218<p>wxMac: Fixed wx.ComboBox to forward the EVT_CHAR, EVT_KEY_DOWN,
219EVT_KEY_UP and EVT_TEXT events from its embedded text control.</p>
220<p>wxMac: Corrected refresh bugs in wxGrid.</p>
221<dl class="docutils">
222<dt>XRCed: Updated to version 0.1.5.</dt>
223<dd><ul class="first last simple">
224<li>Added wxWizard, wxWizardPageSimple (only from pull-down menu).</li>
225<li>Hide command for test window.</li>
226<li>Replacing classes works better.</li>
227<li>Added Locate tool.</li>
228</ul>
229</dd>
230</dl>
231</div>
232<div class="section" id="id4">
233<h1><a name="id4">2.5.5.1</a></h1>
234<ul class="simple">
235<li>8-Apr-2005</li>
236</ul>
237<p>wxMSW: Fixed bug #1022383, 'several ComboBoxes appear selected'</p>
238<p>wx.grid.Grid: Fixed bug #1163384. Moved the code that handles
239activating the cell editors to a EVT_CHAR event handler. This is done
240so the character inserted into the editor will be the &quot;cooked&quot; char
241value (including accented or composed keys) rather than the raw code
242provided by the EVT_KEY_DOWN event.</p>
243<p>Added orient parameter to wx.MDIParentFrame.Tile()</p>
244<p>wxMSW: wxTextCtrl with wx.TE_RICH2 style now uses RichEdit 4.1 if
245available.</p>
246<p>Added GetCount, GetCountRGB, and GetCountColour methods to
247wx.ImageHistogram.</p>
248<p>wxMSW: wx.Window.Refresh changed to explicitly refresh all children as
249well as the parent. Previously it was implicitly done because parents
250did not clip their children by default. Now that they always clip
251children then Refresh needed to be fixed to do a recursive refresh.
252This also fixes the Freeze/Thaw problems that some people had with
2532.5.4.1.</p>
254<p>wx.SplitterWindow: Send EVT_SPLITTER_SASH_POS_CHANGED only once after
255end of dragging and not after each CHANGING event (modified patch
256#1076226)</p>
257<p>wx.glcanvas.GLCanvas: applied patch fixing problems with X server
258crash when using nVidia cards (patch 1155132)</p>
259<dl class="docutils">
260<dt>wx.lib.mixins.listctrl: Patches from Toni Brkic:</dt>
261<dd><ul class="first last simple">
262<li>Bugfix for TextEditMixin when the view can't be scrolled</li>
263<li>Enhancement for ListCtrlAutoWidthMixin, allowing it to manage
264the width of any column.</li>
265</ul>
266</dd>
267</dl>
268<p>wxMac: removal and reusing toolbar tools like the other platforms is
269now possible.</p>
270<p>wxMac: Correct radio tool selection after calling Realize a 2nd time.</p>
271<p>wxMSW: Applied patch #1166587, removes all flicker from wx.StaticBox</p>
272<p>Added wx.lib.foldpanelbar, Andrea Gavana's port of Jorgen Bodde's C++
273wxFoldPanelBar classes to Python.</p>
274<p>wxGTK: Applied patch #1173802, reimplementation of GtkFileChooser
275wxFileDialog by Mart Raudsepp. Note that this new file dialog is only
276used on GTK2 &gt;= 2.4. For earlier GTK2 versions and GTK1 then the
277older generic file dialog is used.</p>
278<p>wxMSW: fixes to static box borders calculations (finalizes patch
279#1166587)</p>
280<p>wx.Image: Use Python's buffer interface API for all image data and
281alpha Set/Get methods and the ImageFromData* constructors. They all
282still copy the buffer except for SetDataBuffer and SetAlphaBuffer, but
283this gives more flexibility on where the data can come from.</p>
284<p>Added MDI support to XRC</p>
285<p>Added wx.animate module and a demo. The wx.animate module provides a
286control that is able to display an animated GIF file.</p>
287<p>wx.lib.plot.py: Applied patch from Werner F. Bruhin that allows either
288vertical and/or horizontal gridlines.</p>
289<p>wxMSW: Extra space given for top border of wx.StaticBoxSizer so the
290upper line is not cliped when there is no label.</p>
291<p>wxMSW: Restored old behaviour of wx.StaticBox.SetBackgroundColour only
292affecting the label.</p>
293<p>wxMSW: Fixed missing EVT_RIGHT_DOWN and EVT_TREE_ITEM_RIGHT_CLICK
294events in a wx.TreeCtrl.</p>
295<p>Added wx.GetTopLevelWindows() function which returns a copy of the
296list of top-level windows that currently exist in the application.</p>
297<p>Updated docview library modules and sample apps from the ActiveGrid
298folks.</p>
299<p>Added the ActiveGrid IDE as a sample application.</p>
300</div>
301<div class="section" id="id5">
302<h1><a name="id5">2.5.4.1</a></h1>
303<ul class="simple">
304<li>16-Mar-2005</li>
305</ul>
306<p>wx.Sizer Add, Insert, and Prepend functions now return a reference to the
307wx.SizerItem that was added to the sizer, and the wx.SizerItem has a
308GetRect accessor to give the position of the item on the parent window.</p>
309<p>Added wx.Sizer.GetItem method which returns the wx.SizerItem for the given
310wx.Window, wx.Sizer or position index.</p>
311<p>wxMSW: wx.RadioButtons in the same group no longer have to be
312consecutive (there may be intervening controls). Without this fix, an
313out-of-sync assert is generated when clicking on a radio button and
314then calling GetValue().</p>
315<dl class="docutils">
316<dt>Some XRC changes:</dt>
317<dd><ul class="first last simple">
318<li>Added 'icon' property to wxFrame and wxDialog</li>
319<li>No longer ignores menu bitmaps on non-MSW platforms</li>
320<li>Notebook page bitmaps are now supported</li>
321<li>added system colours and fonts support (based on patch #1038207)</li>
322</ul>
323</dd>
324</dl>
325<p>wxMSW: fix for [ 1052989 ] TextCtrl.SetBackgroundColour(wx.NullColour)
326bug.</p>
327<p>Added wx.PasswordEntryDialog analagous to wx.TextEntryDialog, allows
328detecting entering an empty string vs. cancel unlike the
329wx.GetPasswordFromUser dialog function.</p>
330<p>OGL patch from Shane Holloway:</p>
331<blockquote>
332<p>Two simple problems found in the new python ogl code. First is
333the patch for _canvas.py. Essentially:</p>
334<pre class="literal-block">
335dx = abs(dc.LogicalToDeviceX(x - self._firstDragX))
336dy = abs(dc.LogicalToDeviceY(y - self._firstDragY))
337</pre>
338<p>was incorrect because (x,y) and (self._firstDragX,
339self._firstDragY) are both already in Logical coordinates.
340Therefore the difference between the two is also in logical
341coordinates, and the conversion call is an error. This bug
342surfaces when you have OGL on a scrollwin, and you are far from
343the origin of the canvas.</p>
344<p>The second change in _composit.py basically removes the assumption
345that the child is in both self._children and self._divisions.
346Causes many problems when it's not. ;)</p>
347</blockquote>
348<p>Fixed GetSaveData and SetSaveData in wx.lib.multisash to not depend on
349the default way that class objectss are converted to strings.</p>
350<p>Fixed problem in StyledTextCtrl.Set[HV]ScrollBar that could leave the
351internal scrollbar visible.</p>
352<p>Added wx.StandardPaths which provides methods for determining standard
353system paths for each platform.</p>
354<p>wxMSW: The window background is now only erased by default if the
355background colour or background mode has been changed. This better
356allows the default system themed behaviour to show through for
357uncustomized windows. Explicit support added for using the correct
358theme texture for wx.Notebook pages and their children.</p>
359<p>wx.Image: Added support for alpha channels in interpolated and
360non-interpolated image rotation. Added ConvertAlphaToMask helper
361method for turning shades of grey into shades of alpha and a colour.</p>
362<p>wxGTK2: Reimplemented DoDrawRotatedText() by way of a rotation of an
363alpha blended text bitmap. It would be better if Pango could draw
364directly into an wxImage (as FreeType can,) but that is for later...</p>
365<p>Added wrappers and a demo for the wx.MediaCtrl class, which can play
366various forms of audio/video media using native codecs install on the
367system. So far it is only implemented for Windows and OSX.</p>
368<p>wxGTK: Patch applied for Freeze()/Thaw() for wxTextCtrtl.</p>
369<p>Added &quot;gravity&quot; for splitter window (patch 1046105). Gravity is a
370floating-point factor between 0.0 and 1.0 which controls position of
371sash while resizing the wx.SplitterWindow. The gravity specifies
372how much the left/top window will grow while resizing.</p>
373<p>wxMSW: wx.Slider's C++ implementation rewritten to be more
374maintainable and hopefully less buggy. The position of the labels has
375also been changed in order to better comply with Microsoft's examples
376of how to use the control.</p>
377<p>wxMSW: Fix wx.TreeCtrl to end label editing if the control loses
378focus (a slightly modified patch 1084592.)</p>
379<p>Added wx.EXEC_NODISABLE flag for wx.Execute, which will prevent all
380the app's windows being disabled while a synchronous child process is
381running.</p>
382<p>wxMSW: Much work to correct painting (or leaving transparent) of
383control backgrounds, properly using background themes on XP, etc.</p>
384<p>Fixed a circular reference problem with wx.Timer. It will now
385completely cleanup after itself when the last reference to the timer
386is removed. If you were previously using timer.Destroy() to cleanup
387your timers it will no longer work. Instead you should hold a
388reference to the timer and then del the reference when you are
389finished with the timer.</p>
390<p>Updated to 1.3.24 of SWIG. All of my big patches have been applied to
391the main SWIG source tree, but unfortunatly there were also some bugs
392added that affected the wxPython build and a few details in my
393original patch were changed/removed, so we are still not free of
394patches. A new patch for SWIG is located in the wxPython/SWIG
395directory of the wxPython source tree. SWIG 1.3.24 plus this patch
396should be used by anyone who is making custom modifications to
397wxPython's .i files, or building their own extension modules or
398etc. that need to interact with the wxPython swigged types. For the
399morbidly curious, here are a few more details:</p>
400<blockquote>
401<ul class="simple">
402<li>Since it is now possible easily and simply share the SWIG type
403tables across modules I reverted to always using the stock SWIG
404runtime instead of my slightly hacked up version of it exported
405via the wxPython C API.</li>
406<li>The %name directive is now deprecated so I replaced most uses of
407it with a custom %Rename macro that uses %rename internally.
408These will evetually need to be replaced with a DocDecl macro
409when docstrings are added for those items.</li>
410<li>The &quot;this&quot; attribute of all SWIGged classes is no longer a
411string containing a &quot;swigified pointer&quot;, but rather a custom
412built-in type that holds the real C pointer to the object and
413the type info. It can be converted to a string like the old
414value using str() or to the long integer value of the pointer
415using long().</li>
416</ul>
417</blockquote>
418<p>Added SetDefaultPyEncoding and GetDefaultPyEncoding functions which
419will set/get the encoding used by wxPython to convert string or
420unicode objects to/from wxString objects. Previously the default
421Python encoding was always used, but unless the user had tweaked their
422sitecustomize.py file it is always &quot;ascii&quot;, which would result in
423errors if the strings contained character codes &gt;= 128.
424SetDefaultPyEncoding will now allow you to control which encoding will
425be used to do those conversions. The default encoding is set to the
426value of <cite>locale.getdefaultlocale()[1]</cite> when wxPython is first
427imported. Please see <a class="reference" href="http://www.alanwood.net/demos/charsetdiffs.html">http://www.alanwood.net/demos/charsetdiffs.html</a>
428for information on the differences between the common latin/roman
429encodings.</p>
430<p>Added wxStdDialogButtonSizer, which is a a special sizer that knows
431how to order and position standard buttons in order to conform to the
432current platform's standards. You simply need to add each <cite>wx.Button</cite>
433to the sizer, and be sure to create the buttons using the standard
434ID's. Then call <cite>Realize</cite> and the sizer will take care of the rest.</p>
435<p>wxMSW Toolbar: pass correct tool id (and not always -1) to the
436EVT_TOOL_RCLICKED handler</p>
437<p>wxGTK: Applied patch for combo box SELECTED events (no longer get
438lots of surplus events)</p>
439<p>wxGTK: Applied patch for proper menu highlight colour detection in
440wx.SystemSettings.</p>
441<p>wxGTK: Commited scrollbar patch #1093339 which sends lineup, linedown
442events based on intercepting the mouse down events.</p>
443<p>wxGTK: Applied patch #1102789 which solved conflicts between wxWidgets
444and GTK+'s context menu code.</p>
445<p>wxGTK: Applied patch #1100327 for correct feedback from DND actions
446(not all actions are allowed).</p>
447<p>Fixed memory leak in wxGrid::UpdateAttr[Rows][Or][Cols] (patch 1104355)</p>
448<p>For efficiency reasons, text controls no longer set the string for
449each text updated event, but rather query for the string value only
450when GetString is called from an event handler.</p>
451<p>Added wx.SL_INVERSE style which will cause wx.Slider to invert the min
452and max ends of the slider.</p>
453<p>Several patches applied, such as #1111174, #1110252 and others, that
454make the generic wx.TreeCtrl (used on wxGTK and wxMac) be more
455conistent with the wxMSW native wx.TreeCtrl.</p>
456<dl class="docutils">
457<dt>XRCed:</dt>
458<dd><ul class="first last simple">
459<li>Edit-&gt;Locate command (Ctrl-L) for quick selection of items.
460Works with event-handling controls (buttons, text fields) but
461not with labels/sizers.</li>
462<li>Some improvements: relative paths for files supplied as command-
463line argument work correctly, notebook panels are highlighted
464better.</li>
465</ul>
466</dd>
467</dl>
468<p>wxMac: Fixed a long-standing issue where wxSlider controls with a
469hardcoded size would misplace their labels behind the slider control.</p>
470<p>wx.HtmlListBox fixed so calling RefreshLine(s) will cause the data for
471that line to be refetched from the overridden methods in the derived
472class.</p>
473<p>The default DoGetBestSize now includes the difference (if any) between
474the client size and total size of the window, (such as the size of
475borders.) Code that sets the client size using the best size, or that
476added extra space to sizers to compensate for this bug may need to be
477changed.</p>
478<p>Can suppress themed notebook pages with the wxNB_NOPAGETHEME style or
479setting system option msw.notebook.themed-background to 0.</p>
480<p>wxSyledTextCtrl updated to use Scintilla 1.62.</p>
481<p>Can now set the msw.window.no-clip-children system option to 1 to
482eliminate weird refresh behaviour (delays between a window being
483erased and repainted, giving a ghostly gradual-redraw effect). May be
484a temporary 'fix' until properly fixed before 2.6.</p>
485<p>wxMac: Toolbar is now more native looking with borderless toolbar
486buttons.</p>
487<p>wxMac: Switched wx.Bitmap to use newer Quartz object types and APIs
488internally. This results in faster display and better alpha support.</p>
489<p>Added wx.DatePickerCtrl.</p>
490<p>wx.html.HtmlWindow now supports background images.</p>
491<p>Added wx.lib.gestures module from Daniel Pozmanter which supports
492using Mouse Gestures in an application.</p>
493<p>wxGTK2: ENTER and LEAVE mouse events are now sent for multi-line text
494controls.</p>
495<p>wxMSW: &quot;Alt&quot; key (VK_MENU) now results in WXK_ALT keyboard event, not
496WXK_MENU</p>
497<p>Added modules from Peter Yared and Morgan Hua that implement the wx
498Doc/View framework in pure Python code. See wx.lib.docview for the
499base implementation and wx.lib.pydocview for Python-specific
500extensions. There are also a couple sample applications located in
501samples/docview.</p>
502<p>Added GetBitmap, GetIcon to wx.ImageList.</p>
503<p>wxGTK wx.Button.SetLabel no longer invalidates/resets the font.</p>
504<p>wx.Sizer.AddWindow, AddSizer, AddSpacer and etc. have now been
505undeprecated at the request of Riaan Booysen, the Boa Constructor team
506lead. Boa needs them to help keep track of what kind of item is being
507managed by the sizer. They are now just simple compatibility aliases
508for Add, and etc.</p>
509<p>The old C++ version of the OGL lib is no longer built by default. Use
510the Python version in the wx.lib.ogl package instead.</p>
511<p>The wx.iewin module is no longer built by default. You can use the
512wx.lib.iewin version instead.</p>
513<p>Fixed wx.BufferedPaintDC for scrolled windows to work whether the
514buffer is covering only the client area or the full virtual area of
515the scrolled window. By default it will assume that only the client
516area is covered. This is different than the old behavior so to
517indicate that the entire virtual area is covered simply add a
518style=wx.BUFFER_VIRTUAL_AREA parameter.</p>
519<p>wx.gizmos.TreeListCtrl: Add support for the EVT_TREE_ITEM_GETTOOLTIP
520event.</p>
521<p>Added Resize, SetRGBRect, Size, and GetOrFindMaskColour methods to
522wx.Image.</p>
523<p>Added wx.Rect.IsEmpty</p>
524<dl class="docutils">
525<dt>wxGTK:</dt>
526<dd><ul class="first last simple">
527<li>Corrected wx.ListBox selection handling</li>
528<li>Corrected default button size handling for different themes</li>
529<li>Corrected splitter sash size and look for different themes</li>
530<li>Fixed keyboard input for dead-keys</li>
531</ul>
532</dd>
533</dl>
534</div>
535<div class="section" id="id6">
536<h1><a name="id6">2.5.3.1</a></h1>
537<ul class="simple">
538<li>9-Nov-2004</li>
539</ul>
540<p>wxMac focus and border refreshes corrected.</p>
541<p>Updated internal PNG library.</p>
542<p>wxMac fix for metal appearance on wx.ToolBar.</p>
543<p>wx.grid.Grid fix allowing DoGetBestSize to be called before CreateGrid
544(which means that a min size doesn't need to be specified.)</p>
545<p>wxMac fix for not sending a native click to a control if it is not
546enabled (does an enable itself)</p>
547<p>Added wx.lib.ogl.DrawnShape, and fixed various little bugs in the new
548OGL.</p>
549<p>Added support to XRC and XRCed for the 3-state checkbox flags and also
550for wx.ToggleButton. Updated the generic window styles supported by
551XRCed.</p>
552<p>It is now possible to create &quot;stock&quot; buttons. Basically this means
553that you only have to provide one of the stock IDs (and either an
554empty label or a label that matches the stock label) when creating the
555button and wxWidgets will choose the stock label to go with it
556automatically. Additionally on the platforms that have a native
557concept of a stock button (currently only GTK2) then the native stock
558button will be used. For example, the following will result in a
559button with &quot;Cancel&quot; as the label and if run on wxGTK2 then there will
560also be an image of a red X:</p>
561<pre class="literal-block">
562b = wx.Button(parent, wx.ID_CANCEL)
563</pre>
564<p>Added wx.lib.ticker.Ticker class from Chris Mellon.</p>
565<p>Fix some incorrect clipping regions in wxSTC on wxGTK.</p>
566<p>Added wrapper for wx.grid.Grid.GetOrCreateCellAttr.</p>
567<p>Removed my copy of distutils from the wxPython source tree. Now that
568I am no longer doing builds on Python 2.1 the newest distutils is no
569longer needed. (There is still one small bug in Python 2.2 distutils
570on win32, but it is easily worked around.) This sovles the problem of
571incorrect builds on some systems where the system installed distutils
572has been patched to behave slightly differently, for example SuSE on
573x86_64 or Chandler's build.</p>
574<p>Updated to SWIG 1.3.22 (plus my patch.) See wxPython/SWIG/README.txt
575in the source tree if you need to use SWIG when building your own copy
576of wxPython, or other extension modules that need to integrate with
577the wxPython modules.</p>
578<p>Added wx.Frame.RequestUserAttention which, if the platform suports it,
579will do something (such as flash the task bar item) to suggest to the
580user that they should look at that window.</p>
581<p>&quot;Fixed&quot; wx.grid.Grid.SetDefaultEditor and SetDefaultRenderer by making
582them register the editor or renderer for the &quot;string&quot; data type.</p>
583<p>Added depth param to wx.Image.ConvertToBitmap.</p>
584<p>Extended the wx.calendar.CalendarCtrl class with methods that get/set
585a Python datetime or date object. (These will only work with Python
5862.3+) The methods are PySetDate, PyGetDate, PySetLowerDateLimit,
587PySetUpperDateLimit, PySetDateRange, PyGetLowerDateLimit, and
588PyGetUpperDateLimit. Also, CalendarEvent was extended with PySetDate
589and PyGetDate methods.</p>
590<p>wxMSW: SetBackgroundColour on a wx.Choice or a wx.ComboBox will now
591also set the colour of the dropdown.</p>
592<p>wxMac: MessageDialog now supports wx.NO_DEFAULT style</p>
593<p>wxMSW: added AssociateHandle and DissociateHandle to wx.Window</p>
594<p>wxMac: fix for toolbar tooltips</p>
595<p>wx.Sizer.Show (and Hide) now take an optional parameter specifying if
596the item to be shown should be searched for recursivly in subsizers,
597and return a boolean value indicating if the item was found.</p>
598<p>wxMSW: fixed MaximizeEvent generation in wx.Frame</p>
599<p>wxMSW: fixed sending duplicate EVT_COMBOBOX events</p>
600<p>Smoother time estimation updates in wx.ProgressDialog (patch 992813)</p>
601<p>Made wx.Listbook events more consistent with wx.Notebook ones (patch
6021001271)</p>
603<p>Fixed rounding errors in variable status bar panes widths computation
604(patch 1030021)</p>
605<p>Added possibility to specify printer bin (patch 910272)</p>
606<p>wxMSW: fixed wx.ListCtrl's SetWindowStyleFlag() to not remove
607WS_VISIBLE; also refresh the control automatically (closes bug
6081019440)</p>
609<p>Added wx.Choicebook, yet another notebook-like control.</p>
610<p>wxMSW: Make radiobutton tab behaviour the same on MSW as in standard
611MSW app, i.e. tab into the activated, not necessarily the first radio
612button.</p>
613<p>Added limited support for wxEventLoop (you can't derive from a
614wx.PyEventLoop version yet...) Updated and moved the sample showing
615how to replace the MainLoop to samples/mainloop/mainloop.py.</p>
616<p>The C++ xrc lib has been moved out of contrib and into the core, so it
617is always built by default. wxPython's build has also changed
618accordingly and will build the xrc module as part of the core set of
619modules built by default. If you were axplicitly using BUILD_XRC then
620it will no longer be recognized as a build option, otherwise you
621should notice no difference.</p>
622<p>wxMac: Fixed radio toolbar buttons to correctly untoggle the others
623when a new one is selected.</p>
624<p>wxMac: Fixed GetLineLength and GetLineText for MLTE text controls</p>
625<p>wxMac: wx.TaskBarIcon is implemented by allowing you to change the
626app's icon on the Dock and also specifying a menu that should be
627merged with the normal dock popup menu. See the MigrationGuide for
628more details and a warning.</p>
629<p>Added wx.TopLevelWindow.IsActive() which tells you if the frame or
630dialog is or containts the active window with the keyboard focus.</p>
631<p>Added ability to create a font based on pixel size rather than point
632size via the FontFromPixelSize constructor.</p>
633<p>Updated the Scintilla used by StyledTextCtrl to version 1.61</p>
634<p>Improved image HitTest for TreeListCtrl.</p>
635<p>Added wx.App.IsMainLoopRunning.</p>
636<p>wxGTK: Make wxComboBox spit out a bit fewer surplus events when
637holding down the mouse button.</p>
638<p>wxGTK: Enable key based navigation through notebook tabs as in the
639native control with Left and right keys. Support for vetoing.</p>
640<p>FloatCanvas updates from Chris Barker</p>
641<dl class="docutils">
642<dt>PyPlot updates from Gordon Williams:</dt>
643<dd><ul class="first last simple">
644<li>Added bar graph demo</li>
645<li>Modified line end shape from round to square.</li>
646<li>Removed FloatDCWrapper for conversion to ints and ints in
647arguments</li>
648<li>Imported modules given leading underscore to name.</li>
649<li>Added Cursor Line Tracking and User Point Labels.</li>
650<li>Demo for Cursor Line Tracking and Point Labels.</li>
651<li>Size of plot preview frame adjusted to show page better.</li>
652<li>Added helper functions PositionUserToScreen and
653PositionScreenToUser in PlotCanvas.</li>
654<li>Added functions GetClosestPoints (all curves) and GetClosestPoint
655(only closest curve) can be in either user coords or screen
656coords.</li>
657</ul>
658</dd>
659<dt>MaskedEdit updates from Will Sadkin:</dt>
660<dd><ul class="first last simple">
661<li>Added '*' mask char that means &quot;all ansii chars&quot; (ords 32-255)</li>
662<li>Added proper unicode support to masked controls and wx.tools.dbg</li>
663<li>Fixed two reported missing import bugs introduced by package
664creation</li>
665<li>Converted masked package doc strings to reST format for better
666epydoc support</li>
667<li>lots of doc string improvements and function hiding to better
668reflect package's public contents.</li>
669</ul>
670</dd>
671</dl>
672<p>Restructured the installer packages slightly to help facilitate having
673multiple versions of wxPython installed at the same time. See the
674Migrarion Guide for more information.</p>
675<dl class="docutils">
676<dt>Applied patch from Pim Van Heuven that modifies 4 files:</dt>
677<dd><ul class="first last simple">
678<li>wxPython/demo/ListCtrl_edit.py (new demo)</li>
679<li>wxPython/demo/Main.py (include new demo in demo app)</li>
680<li>wxPython/wx/lib/mixins/listctrl.py (several improvements to
681TextEditMixin)</li>
682<li>wxPython/wx/lib/wxpTag.py (some small fixes)</li>
683</ul>
684</dd>
685</dl>
686<p>Added (thanks to Kevin Ollivier!) wrappers for wx.WebKitCtrl for the
687OSX build. Other platforms will raise an exception if you try to use
688it.</p>
689<p>wxPython on OSX can now be built in Unicode mode, can support multiple
690version installs, and comes with an uninstaller script.</p>
691</div>
692<div class="section" id="id7">
693<h1><a name="id7">2.5.2.8</a></h1>
694<ul class="simple">
695<li>27-Aug-2004</li>
696</ul>
697<p>Predominantly a bug-fix release.</p>
698<blockquote>
699<ul class="simple">
700<li>Fixed fatal error due to improper wrapping of wx.FSFile.</li>
701<li>Fixed return type of EditableListBox.GetListCtrl</li>
702<li>Give generic tree and list controls a DoGetBestSize so they play
703nicer with sizers when there is no minimal size.</li>
704<li>Some tweaks in the demo and samples to correct layout, some
705flicker problems, and namespace use.</li>
706<li>Add wx.Image.ConvertAlphaToMask</li>
707<li>Minor corrections in wx.lib.dialogs</li>
708<li>wx.FileHistory constructor now accepts the documented 2nd
709parameter.</li>
710<li>Corrections for exceptions in the new ogl</li>
711<li>Fixed XRCed to not use reparenting of windows to implement caching
712of property panels, since Reparent on wxMac is not implemented.</li>
713<li>Add support for wxTAB_TRAVERSAL to the XRC handler for
714wxScrolledWindow.</li>
715<li>Add support for all wxListBox styles to the XRC handler for
716wxCheckListBox.</li>
717<li>Fix for wx.Listbook.DeleteAllPages to really delete everything.</li>
718<li>wxGTK2 now supports alpha blended bitmap drawing</li>
719<li>Made wx.grid.Grid play nicer with sizers.</li>
720<li>etc.</li>
721</ul>
722</blockquote>
723</div>
724<div class="section" id="id8">
725<h1><a name="id8">2.5.2.7</a></h1>
726<ul class="simple">
727<li>14-Aug-2004</li>
728</ul>
729<p>wx.ADJUST_MINSIZE is now the default behaviour for window items in
730sizers. This means that the item's GetMinSize and/or GetBestSize will
731be called when calculating layout and the return value from that will
732be used for the minimum size used by the sizer. The wx.FIXED_MINSIZE
733flag was added that will cause the sizer to use the old behaviour in
734that it will <em>not</em> call the window's methods to determine the new best
735size, instead the minsize that the window had when added to the sizer
736(or the size the window was created with) will always be used. Please
737see the Sizers section in the Migration Guide for more details.</p>
738<p>Added new MaskedEditControl code from Will Sadkin. The modules are
739now locaed in their own sub-package, wx.lib.masked. Demos updated.</p>
740<p>The changes that implemented the incompatible wx.DC methods in 2.5.1.5
741have been reverted. The wx.DC methods are now compatible with the 2.4
742implemetation. In addition a set of renamed methods have been added
743that take wx.Point and/or wx.Size objects instead of individual
744parameters.</p>
745<p>Added wx.lib.mixins.listctrl.TextEditMixin, a mixin class that allows
746all columns of a wx.ListCtrl in report mode to be edited.</p>
747<p>Deprecated the wx.iewin module.</p>
748<p>Deprecated the wx.Sizer.AddWindow, AddSizer, AddSpacer methods as well
749as their Insert* and Prepend* counterparts.</p>
750<p>Added a generic StaticBitmap class in wx.lib.statbmp for the same
751reasons that stattext was created, so it could be mouse sensitive on
752all platforms like normal windows. Also updated stattext.py and
753buttons.py to handle attribute (font &amp; colour) defaults and
754inheritance the new way. If you have custom controls of your own you
755should review stattxt.py or one of the others to see how it is to be
756done.</p>
757<p>wx.InitAllImageHandlers is now an empty function that does nothing but
758exist for backwards compatibility. The C++ version is now called
759automatically when wxPython is initialized. Since all the handlers
760are included in the wxWidgets shared library anyway, this imposes only
761a very small amount of overhead and removes several unneccessary
762problems.</p>
763<p>Replaced wx/lib/pubsub.py with a version that uses weak references to
764track the subscribers, plus other fixes/additions. Thanks go to
765Oliver Schoenborn and Robb Shecter.</p>
766<p>wxGTK now uses gtk_init_check so wxPython can raise an exception if
767there is no DISPLAY available or other initializaion problem.</p>
768<p>wx.GetKeyState now has an implementation for wxGTK and is able to
769detect the up/down or toggle state of modifier and toggle keys.</p>
770<p>The LC_NUMERIC locale is now reset back to &quot;C&quot; (compatibility) when
771running on wxGTK to work around the fact that GTK requires the locale
772to be set to the system settings but Python depends on LC_NUMERIC
773remaining compatible with &quot;C&quot;.</p>
774<p>Switched gizmos.TreeListCtrl to the newer version of the code from the
775wxCode project.</p>
776<p>OGL is dead! LONG LIVE OGL! (Oops, sorry. A bit of my dramatic side
777leaked out there...) The wx.ogl module has been deprecated in favor
778of the new Python port of the OGL library located at wx.lib.ogl
779