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