wxPython/docs/CHANGES.txt

   1 Recent Changes for wxPython
   2 =====================================================================
   3
   4 2.7.0.1
   5 -------
   6 *
   7
   8 The following deprecated items have been removed:
   9
  10     * wx.Bitmap SetQuality and GetQuality methods
  11
  12     * The wx.GetNumberFromUser function
  13
  14     * wx.EVT_LIST_GET_INFO and wx.EVT_LIST_SET_INFO
  15
  16     * wx.BookCtrlSizer and wx.NotebookSizer
  17
  18     * The PostScript-specific methods of wx.PrintData
  19
  20     * wx.PrintDialogData SetSetupDialog and GetSetupDialog methods
  21
  22     * wx.FontMapper SetConfig method
  23
  24     * wx.html.HtmlSearchStatus.GetContentsItem method
  25
  26     * wx.html.HtmlHelpData.GetContents, GetContentsCnt, GetIndex, and
  27       GetIndexCnt methods
  28
  29
  30 wx.EventLoop is now implemented for wxMac.
  31
  32 Added wxPython wrappers for the new wx.Treebook and wx.Toolbook
  33 classes.
  34
  35 wx.DC.BeginDrawing and EndDrawing have been deprecated in the C++
  36 code, so since they never really did anything before they are now just
  37 empty stubs in wxPython.
  38
  39 Solved a problem that has been around for a very long time in how C++
  40 methods are virtualized for overriding in derived Python classes.
  41 Previously we couldn't do it for methods that needed to also exist in
  42 the base class wrappers such that they could be called normally.  (The
  43 reasons are long and complex, but suffice it to say that it was due to
  44 mixing C++'s dynamic dispatch, and Python's runtime lookup of the
  45 method attributes resulting in endless recursion of function calls.)
  46 Because of this problem I used a hack that I have always hated, and
  47 that is renaming the base class methods with a "base_*" prefix, for
  48 example wx.Printout.base_OnBeginDocument.  Now that the problem has
  49 finally been solved I have replaced all the base_Whatever() methods
  50 with the real Whatever() method as well as a simple wrapper named
  51 base_Whatever that is marked as deprecated.  So now instead of writing
  52 your overridden methods like this::
  53
  54     def OnBeginDocument(self, start, end):
  55         # do something here
  56         return self.base_OnBeginDocument(start, end)
  57
  58 You can now call the base class method the normal way, like this::
  59
  60     def OnBeginDocument(self, start, end):
  61         # do something here
  62         return Printout.OnBeginDocument(self, start, end)
  63
  64 Or like this with super()::
  65
  66     def OnBeginDocument(self, start, end):
  67         # do something here
  68         return super(MyPrintout, self).OnBeginDocument(start, end)
  69
  70
  71 Note that the old way with the "base_*" function still works, but you
  72 will get a DeprecationWarning from calling base_OnBeginDocument.  The
  73 classes affected by this are:
  74
  75     * wx.DropSource
  76     * wx.DropTarget
  77     * wx.TextDropTarget
  78     * wx.FileDropTarget
  79     * wx.PyLog   (also added the ability to override Flush)
  80     * wx.PyApp   (also added the ability to override ExitMainLoop)
  81     * wx.Printout
  82     * wx.PyPrintPreview
  83     * wx.PyPreviewFrame
  84     * wx.PreviewControlBar
  85     * wx.Process
  86     * wx.PyControl
  87     * wx.PyPanel
  88     * wx.PyScrolledWindow
  89     * wx.PyWindow
  90     * wx.Timer
  91     * wx.grid.PyGridCellRenderer
  92     * wx.grid.PyGridCellEditor
  93     * wx.grid.PyGridCellAttrProvider
  94     * wx.grid.PyGridTableBase
  95     * wx.html.HtmlWindow
  96     * wx.wizard.PyWizardPage
  97
  98
  99 Added the wx.DC.GradientFillConcentric and wx.DC.GradientFillLinear
 100 methods.
 101
 102 wxGTK: wx.ListBox and wx.CheckListBox are now using native GTK2
 103 widgets.
 104
 105 Added wx.ListBox.HitTest() from patch 1446207
 106
 107 Bumped up to SWIG 1.3.29.  This provides some more runtime performance
 108 boosts, gets rid of the dreaded Ptr classes, and some other nice new
 109 things.
 110
 111 Added wx.Window.GetScreenPosition and GetScreenRect which returns the
 112 position of the window in screen coordinates, even if the window is
 113 not a top-level window.
 114
 115 Added GetResourcesDir and GetLocalizedResourcesDir to
 116 wx.StandardPaths.
 117
 118 Added a GetReceivedFormat method to wx.DataObjectComposite.  You can
 119 use this to find out what format of data object was recieved from the
 120 source of the clipboard or DnD operation, and then you'll know which
 121 of the component data objects to use to access the data.
 122
 123 Changed how the stock objects (wx.RED, wx.RED_PEN, wx.RED_BRUSH, etc.)
 124 are initialized.  They are now created as uninitialized instances
 125 using __new__.  Then after the wx.App has been created, but before
 126 OnInit is called, the .this attribute of each obhect is initialized.
 127 This was needed because of some delayed initialization functionality
 128 that was implemented in wxWidgets, but the end result is cleaner for
 129 wxPython as well, and allowed me to remove some ugly code previously
 130 hidden under the covers.
 131
 132 Added wx.StandardPaths.GetDocumentsDir.
 133
 134 Added wx.RendererNative.DrawCheckButton.
 135
 136 wx.ProgressDialog.Update now returns a tuple of two values.  The first
 137 is a continue flag (what was returned before) and the second is a skip
 138 flag.  If the dialog has the wx.PD_CAN_SKIP flag and if the Skip
 139 button is clicked, then the skip flag is set to True the next time
 140 Update is called.
 141
 142 A DeprecationWarning is now issued when the old wxPython package is
 143 imported.  If you are still using the old namespace please convert
 144 your code to use the new wx package instead.
 145
 146 Added wrappers for Julian's new wxRichTextCtrl class, visible in
 147 wxPython as wx.richtext.RichTextCtrl window.  It still needs some more
 148 work, but it is a great start.
 149
 150 wx.lib.mixins.listctrl.TextEditMixin: Fixed the double END_LABEL_EDIT
 151 event problem in TextEditMixin by checking if the editor was already
 152 hidden before continuing with the CloseEditor method.  Also added code
 153 to OpenEditor to send the BEGIN_LABEL_EDIT event and to not allow the
 154 opening of the editor to continue if the event handler doesn't allow
 155 it.
 156
 157 wx.StaticBoxSizer now keeps better track of the wx.StaticBox, and it
 158 will destroy it if the sizer is destroyed before the parent window is.
 159
 160 Added wx.HyperlinkCtrl.
 161
 162 Added battery and power related functions and events (wxMSW only so
 163 far.)  See wx.PowerEvent, wx.GetPowerType and wx.GetBatteryState.
 164
 165 Added wx.ListCtrl.HitTestSubItem which returns the sub-item (i.e. the
 166 column in report mode) that was hit (if any) in addition to the item
 167 and flags.
 168
 169 Added wrappers for wx.ColourPickerCtrl, wx.DirPickerCtrl,
 170 wx.FilePickerCtrl, and wx.FontPickerCtrl.
 171
 172 Patch #1502016 wx.Image.ConvertToGreyscale now retains the alpha
 173 channel.
 174
 175 Added wrappers for the wxAUI classes, in the wx.aui module.
 176
 177 Added the PseudoDC class from Paul Lanier.  It provides a way to
 178 record operations on a DC and then play them back later.
 179
 180 Upgraded to Scintilla 1.70 for wx.stc.StyledTextCtrl.
 181
 182 Added CanSetTransparent and SetTransparent methods to the
 183 wx.TopLevelWindow class, with implementations (so far) for wxMSW and
 184 wxMac.
 185
 186 SetDefaultItem() and GetDefaultItem() are now members of
 187 wx.TopLevelWindow, not wx.Panel.
 188
 189 wxGTK: Stock items (icons) will be used for menu items with stock
 190 IDs.
 191
 192 Added wx.lib.combotreebox from Frank Niessink
 193
 194 Added wx.ImageFromBuffer, wx.BitmapFromBuffer and
 195 wx.BitmapFromBufferRGBA factory functions.  They enable loading of an
 196 image or bitmap directly from a Python object that implements the
 197 buffer interface, such as strings, arrays, etc.
 198
 199 Added wx.App.IsDisplayAvailable() which can be used to determine if a
 200 GUI can be created in the current environment.  (Still need an
 201 implementation for wxMSW...)
 202
 203 The wx.html.HTML_FONT_SIZE_x constants are no longer available as the
 204 default sizes are now calculated at runtime based on the size of the
 205 normal GUI font.
 206
 207 wx.Colour now includes an alpha component, which defaults to
 208 wx.ALPHA_OPAQUE.  This is in preparation for allowing various new
 209 alpha blening functionality using wx.Colour objects, such as drawing
 210 with pens and brushes on a wx.DC.
 211
 212 Added wx.NativePixelBuffer, wx.AlphPixelBuffer and related iterator
 213 and accessor classes.  They allow platform independent direct access
 214 to the platform specific pixel buffer inside of a wx.Bitmap object.
 215
 216 The beginnings of support for RTL languages has been added, thanks to
 217 a Google SoC project.
 218
 219 Added wx.lib.dragscroller from Riaan Booysen.  It provides a helper
 220 class that can used to scroll a wx.ScrolledWindow in response to a
 221 mouse drag.
 222
 223 Applied patch 1551409: Adds support for indeterminate mode gauges.
 224
 225 wxMac: I've turned on the compile option for using the native toolbar
 226 on the Mac now that it supports hosting of controls.  If the toolbar
 227 is managed by the frame via either CreateToolBar() or SetToolBar()
 228 then the native toolbar will be used.  Additional toolbars, or
 229 toolbars that are not children of the frame, are managed by sizers or
 230 what-not will still use the emulated toolbar because of platform
 231 restrictions in how/where the native toolbar can be used.
 232
 233 Added Python properties for many of the getter/setter methods of wx
 234 classes.  In order for the names to be predicatble for somebody
 235 already familiar with wxPython the property names are simply the name
 236 of the getter with the "Get" dropped.  For example, wx.Window has a
 237 property named "Size" that maps to GetSize and SetSize.  So far there
 238 is only one known name conflict using this naming convention, and that
 239 is wx.KeyEvent.KeyCode, however since KeyCode was formerly a
 240 compatibility alias for GetKeyCode (and has been for a long time) it
 241 was decided to just switch it to a property.  If you want to use the
 242 method then change your calls to event.KeyCode() to
 243 event.GetKeyCode(), otherwise you can use it as a property just by
 244 dropping the parentheses.
 245
 246 Updated the C++ code for wx.gizmos.TreeListCtrl from the wxCode
 247 project.  This has resulted in some minor API changes, most of which
 248 were worked around in the wrapper code.
 249
 250 Added wx.lib.delayedresult from Oliver Schoenborn.
 251
 252 Added wx.lib.expando, a multi-line textctrl that exands as more lines
 253 are needed.
 254
 255 wx.Image.Scale and Rescale methods now take an extra parameter
 256 specifying type of method to use for resampling the image.  It
 257 defaults to the current behavior of just replicating pixels, if
 258 wx.IMAGE_QUALITY_HIGH is passed then it uses bicubic and box averaging
 259 resampling methods for upsampling and downsampling respectively.
 260
 261
 262
 263
 264
 265
 266 2.6.3.3
 267 -------
 268 * 15-July-2006
 269
 270 wx.lib.pubsub updates from Oliver Schoenborn:
 271     - fixed the hash problem with non-hashable objects
 272     - now supports listeners that use \*args as an argument
 273       (listener(\*args) was not passing the validity test)
 274     - corrected some mistakes in documentation
 275     - added some clarifications (hopefully useful for first time
 276       users)
 277     - changed the way singleton is implemented since old way prevented
 278       pydoc etc from extracting docs for Publisher
 279
 280 DocView and ActiveGrid IDE updates from Morgan Hua:
 281     New Features: In Tab-View mode, Ctrl-number will take the user to
 282     the numbered tab view.  Modified files now show an '*' astrisk in
 283     the view title.  Debugger framework can now support PHP debugging.
 284     Not important for python development, but at least that means the
 285     debugger framework is more generalized.
 286
 287 wx.lib.mixins.listctrl.TextEditMixin: Fixed the double END_LABEL_EDIT
 288 event problem in TextEditMixin by checking if the editor was already
 289 hidden before continuing with the CloseEditor method.  Also added code
 290 to OpenEditor to send the BEGIN_LABEL_EDIT event and to not allow the
 291 opening of the editor to continue if the event handler doesn't allow
 292 it.
 293
 294 Undeprecated wx.GetNumberFromUser and added wx.NumberEntryDialog.
 295
 296 Made necessaary changes for building wxPython for Python 2.5.  There
 297 may still be some issues related to the new Py_ssize_t type and 64-bit
 298 machines, but at least all compile errors and warnings related to it
 299 have been resolved.
 300
 301
 302
 303
 304 2.6.3.2
 305 -------
 306 * 3-April-2006
 307
 308 Fixed reference leak in wx.gizmos.TreeListCtrl.GetSelections.
 309
 310 wxMSW: Fixed sizing issue with wx.Choice and wx.ComboBox.  This change
 311 was implemented by reverting a prior fix for a different problem
 312 (contiuous painting/resizing when a combobox is used as a widget in a
 313 wx.html.HtmlWindow) so a method to fix both problems is still being
 314 investigated.
 315
 316 wxGTK: Fixed potential buffer overrun when pasting from the
 317 clipboard.
 318
 319 Fixed problem in wx.lib.splitter when used on 64-bit platforms.  Used
 320 the current length of the list for specifying an append instead of
 321 sys.maxint.
 322
 323 wxMSW: Support added for XP themed owner drawn buttons and bitmap
 324 buttons.  For example, if you change the foreground color of a button
 325 it will now be drawn with the XP themed style rather than an ugly
 326 generic button style.
 327
 328 XRCed: Fix for Copy/Paste objects with international characters.
 329
 330 Fixed the equality and inequality operators for some of the basic
 331 data types (wx.Point, wx.Size, wx.Colour, etc.) to no longer raise a
 332 TypeError if the compared object is not compatible, but to just return
 333 a boolean as expected.  For example::
 334
 335           wx.Colour(64,0,64) == 123      ==> False
 336
 337 wxMSW: Fixed (again) sizing/positioning issues of calling Realize on
 338 a wx.ToolBar that is not manaaged directly by a frame and that is
 339 already shown.
 340
 341 wxMSW: Fixed wx.Choice/wx.ComboBox so they send events when a new item
 342 is selected only with the keyboard.
 343
 344
 345
 346 2.6.3.0
 347 -------
 348 * 27-March-2006
 349
 350 Change the wx.ListCtrl InsertStringItem wrapper to use the form that
 351 takes an imageIndex, and set the default to -1.  This ensures that on
 352 wxMSW that if there is an image list but they don't specify an image,
 353 the native control doesn't use one anyway.
 354
 355 wxMSW: wx.ListCtrl in report mode is now able to support images in
 356 other columns besides the first one.  Simply pass an image index to
 357 SetStringItem.  For virtual list controls you can specify the image to
 358 use on the extra columns by overriding OnGetItemColumnImage in your
 359 derived class.  It is passed the item number and the column number as
 360 parameters, and the default version simply calls OnGetItemImage for
 361 column zero, or returns -1 for other columns.
 362
 363 Switched to using SWIG 1.3.27 for generating the wrapper code.  There
 364 are some small changes needed to SWIG to work around some bugs that
 365 wxPython exposes, and to be able to generate code that matches that
 366 which wxPython is using.  If you are building wxPython yourself and
 367 need to modify any of the \*.i files or to add your own, then you will
 368 want to be sure to use a matching SWIG.  See wxPython/SWIG/README.txt
 369 in the source tarball for details.
 370
 371 wx.Image.Copy, Mirror, and GetSubImage now also do the right thing
 372 with  the alpha channel.
 373
 374 wxMSW: Fixed problem in wx.TextCtrl where using SetValue and
 375 wx.TE_RICH2 would cause the control to be shown if it was hidden.
 376
 377 wxMSW: Numpad special keys are now distinguished from normal keys in
 378 key events.
 379
 380 wxMSW: Multiline notebook tab label change now resizes the control
 381 correctly if an extra row is removed or added.
 382
 383 wxMSW: On XP fall back to unthemed wxNotebook if specified orientation
 384 not available in the themed version.
 385
 386 Added wx.Toolbar.GetToolsCount.
 387
 388 Added wx.GridSizer.CalcRowsCols.
 389
 390 Added wx.OutputStream.LastWrite.
 391
 392 wxGTK: EVT_SET_CURSOR is now sent.
 393
 394 wxGTK: Fix RequestMore for idle events.
 395
 396 wxGTK: Implement user dashes for PS and GNOME printing.
 397
 398 wxGTK: Correct update region code. Don't always invalidate the whole
 399 window upon resize. Reenable support for thewx.NO_FULL_REPAINT_ON_RESIZE
 400 flag.  Also disable refreshing custom controls when focusing in and out.
 401
 402 wx.lib.pubsub: Publisher is now able to parse a dotted notation string
 403 into a topic tuple.  For example: subscribing to "timer.clock.seconds"
 404 is the same as subscribing to ("timer", "clock", "seconds").
 405
 406 Applied patch #1441370: lib.plot - allow passing in wx.Colour()
 407
 408 Added wx.CommandEvent.GetClientData.
 409
 410 Updated wxStyledTextCtrl to use version 1.67 of Scintilla.
 411 NOTE: The STC_LEX_ASP and STC_LEX_PHP lexers have been deprecated,
 412 you should use STC_LEX_HTML instead.
 413
 414 wxSTC: Implemented Fix for SF Bug #1436503.  Delay the start of the
 415 DnD operation in case the user just intended to click, not drag.
 416
 417 Updated the analogclock.py module to the new analogclock package from
 418 E. A. Tacao.
 419
 420 Added the wx.lib.mixins.listctrl.CheckListCtrlMixin class from Bruce
 421 Who, which makes it easy to put checkboxes on list control items.
 422
 423 Applied a patch from Christian Kristukat to wx.lib.plot that adds
 424 scrollbars when the plot is zoomed in, and also the ability to grab a
 425 zoomed plot and move it around with a mouse drag.
 426
 427 XRCed updated to allow wxMenuBar to be created inside a wxFrame.
 428
 429 Added wx.StandardPaths.GetDocumentsDir() (patch 1214360)
 430
 431
 432
 433
 434
 435
 436 2.6.2.1
 437 -------
 438 * 10-Jan-2006
 439
 440 wxMSW: Fix for bug #1211907, popup menu indenting inconsistent with
 441 bitmaps.
 442
 443 wxMac: Don't send an event for wx.RadioButton deselections, just the
 444 selections.  This was done to make it consistent with the other
 445 platforms.
 446
 447 wxMSW: Always set flat toolbar style, even under XP with themes: this
 448 is necessary or separators aren't shown at all.
 449
 450 Fixes for bug #1217872, pydocview.DocService not correctly initialized.
 451
 452 Fix for bug #1217874, Error in parameter name in DocManager.CreateView.
 453
 454 Added wrappers for the wx.RendererNative class.
 455
 456 Added the wx.lib.splitter module, which contains the
 457 MultiSplitterWindow class.  This class is much like the standard
 458 wx.SplitterWindow class, except it allows more than one split, so it
 459 can manage more than two child windows.
 460
 461 Docview and IDE patch from Morgan Hua with fix for bug #1217890
 462 "Closing view crashes Python" plus some new features:
 463
 464     New feature added to the IDE is 'Extensions'.  Under
 465     Tools|Options|Extensions, you can add calls to external programs.
 466     For example you can add a "Notepad" extension (under windows) that
 467     will exec Notepad on the currently open file.  A new "Notepad"
 468     menu item will appear under the Tools menu.
 469
 470 Some fixes to XRCed to make encoding errors a bit more user friendly.
 471
 472 XRCed changes from Roman Rolinsky:
 473
 474     * Added new controls (Choicebook, Listbook, StatusBar,
 475       DatePicker), and completed style flags. Test window is opened
 476       for an available parent control if no specific view
 477       defined. Better handling of exceptions (highlighting does not
 478       'stick' anymore).
 479
 480     * Use system clipboard for Copy/Paste.
 481
 482     * Improved some dialogs (window styles, growable cols). Changed
 483       the range for wxSpinCtrl min/max to all integers (default 0/100
 484       is not always good).
 485
 486 Updates for wx.lib.foldpanelbar and wx.lib.hyperlink from Andrea
 487 Gavana.
 488
 489 Fix for Bug #1283496: wxPython TheClipboard class causes problems for
 490 pychecker.  Ensure the app has been created before initializing
 491 wx.TheClipboard.
 492
 493 Fix for Bug #1352602: FileBrowseButtonWithHistory can't type in Value.
 494
 495 wxHTML: Added space after list item number.
 496
 497 wx.lib.printout:  Applied patch #1384440.
 498
 499 wxMSW:  Fix for Bug #1293225 Window_FromHWND crashes if parent is
 500 None.
 501
 502 Fix for Bug #1261669, use a wx.TE_RICH2 style for the Process demo so
 503 it doesn't fill up too soon.
 504
 505 Applied Patch #1354389: wxPython MenuItem SetBitmaps fix.
 506
 507 Applied Patch #1239456: wxPython wx.DataObject.GetAllFormats fix.
 508
 509 Applied Patch # #1230107 which allows image handlers to be written in
 510 Python by deriving from wx.PyImageHandler.
 511
 512 Applied patch #1072210: generalize printout.py to allow text printing.
 513
 514 Applied patch #1243907: Give Throbber much more flexibility by
 515 allowing the user to set the rest image, the direction, the current
 516 index, custom sequence.  Allows user to manually step through the
 517 sequence with Next(), Previous(), Increment(), Decrement() &
 518 SetCurrent(). Very handy if you have multiple throbbers that you want
 519 to synchronize with a single timer.
 520
 521 Fix for bug #1336711: wx.lib.calendar.CalenDlg can yield incorrect
 522 result.
 523
 524 Applied patch from Morgan Hua for updates to ActiveGrid code
 525 (pydocview, ActiveGrid IDE, etc.)
 526
 527 Applied patch #1326241: Supporting "setup.py install --install-headers=path"
 528
 529 Applied patch from Morgan Hua to fix bug #1219423: CommandManager
 530 should not repeat old commands after a branch.
 531
 532 Applied patch #1238825 adding search backward capabilities to the
 533 demo.  Modified to use the up/down options in the wx.FindReplaceDialog
 534 instead of a separate menu item.
 535
 536 Fix for bug #1266745 and #1387725 in the wx.FindReplaceDialog on MSW.
 537 Actually check we are using MSLU before doing the hack designed to
 538 workaround a bug in MSLU!
 539
 540 wxMSW: wx.lib.iewin.IEHtmlWindow now properly handles tabbing, return
 541 and other special keys properly.
 542
 543 Lots of PyCrust enhancments started by Franz Steinaeusler, Adi Sieker,
 544 and Sebastian Haase, and which in turn were further enhanced, fixed
 545 tweaked and finished up by me.  The changes include the following:
 546
 547     * The Autocomplete and Calltip windows can now be opened manually
 548       with Ctrl-Space and Ctrl-Shift-Space.
 549
 550     * In the stand alone PyCrust app the various option settings,
 551       window size and position, and etc. are saved and restored at the
 552       next run.
 553
 554     * Added a help dialog bound to the F1 key that shows the key
 555       bindings.
 556
 557     * Added a new text completion function that suggests words from
 558       the history.  Bound to Shift-Return.
 559
 560     * F11 will toggle the maximized state of the frame.
 561
 562     * switched to Bind() from wx.EVT_*().
 563
 564     * Display of line numbers can be toggled.
 565
 566     * F12 toggles a "free edit" mode of the shell buffer.  This mode
 567       is useful, for example, if you would like to remove some output
 568       or errors or etc. from the buffer before doing a copy/paste.
 569       The free edit mode is designated by the use of a red,
 570       non-flashing caret.
 571
 572     * Ctrl-Shift-F will fold/unfold (hide/show) the selected lines.
 573
 574     * General code cleanup and fixes.
 575
 576     * Use wx.StandardPaths to determine the location of the config
 577       files.
 578
 579     * Use wx.SP_LIVE_UPDATE on crust and filling windows.
 580
 581     * Extended the saving of the config info and other new features to
 582       the PyShell app too.  Additionally, other apps that embed a
 583       PyCrust or a PyShell can pass their own wx.Config object and
 584       have the Py code save/restore its settings to/from there.
 585
 586     * All of the classes with config info get an opportunity to
 587       save/load their own settings instead of putting all the
 588       save/load code in one place that then has to reach all over the
 589       place to do anything.
 590
 591     * Enable editing of the startup python code, which will either be
 592       the file pointed to by PYTHONSTARTUP or a file in the config dir
 593       if PYTHONSTARTUP is not set in the environment.
 594
 595     * Added an option to skip the running of the startup code when
 596       PyShell or PyCrust starts.
 597
 598     * PyCrust adds a pp(item) function to the shell's namespace that
 599       pretty prints the item in the Display tab of the notebook.
 600       Added code to raise that tab when pp() is called.
 601
 602     * Added an option for whether to insert text for function
 603       parameters when popping up the call tip.
 604
 605     * Added Find and Find-Next functions that use the
 606       wx.FindReplaceDialog.
 607
 608
 609 Applied patches from Will Sadkin for wx.lib.masked modules:
 610
 611     * Now ignores kill focus events when being destroyed.
 612
 613     * Added missing call to set insertion point on changing fields.
 614
 615     * Modified SetKeyHandler() to accept None as means of removing
 616       one.
 617
 618     * Fixed keyhandler processing for group and decimal character
 619       changes.
 620
 621     * Fixed a problem that prevented input into the integer digit of a
 622       integerwidth=1 numctrl, if the current value was 0.
 623
 624     * Fixed logic involving processing of "_signOk" flag, to remove
 625       default sign key handlers if false, so that
 626       SetAllowNegative(False) in the NumCtrl works properly.
 627
 628     * Fixed selection logic for numeric controls so that if
 629       selectOnFieldEntry is true, and the integer portion of an
 630       integer format control is selected and the sign position is
 631       selected, the sign keys will always result in a negative value,
 632       rather than toggling the previous sign.
 633
 634 wx.FontMapper.SetConfig is deprecated.  You should instead just set an
 635 application-wide config object with wx.Config.Set, which wx.FontMapper
 636 will use by default.
 637
 638 Added wx.GetMouseState which returns the current state of the mouse.
 639 It returns an instance of a wx.MouseState object that contains the
 640 current position of the mouse pointer in screen coordinants, as well
 641 as boolean values indicating the up/down status of the mouse buttons
 642 and the modifier keys.
 643
 644 Added wx.SizerItem.SetUserData
 645
 646 A variety of updates to wx.lib.floatcanvas, including Added
 647 DrawObjects, including a ScaledTextBox, with auto-wrapping, etc, and
 648 Scaled and Unscaled Bitmap Objects.
 649
 650        WARNING: Changed all DrawObjects to take an (x,y) pair rather
 651        than individual x,y parameters. Also changed rectangles and
 652        ellipses to take (w,h) pair. This is an API change, but should
 653        be easy to accommodate, all you need to do is add a parenthesis
 654        pair:  (...x, y, ...) --->  (...(x,y), ...)
 655
 656
 657
 658
 659 2.6.1.0
 660 -------
 661 * 4-June-2005
 662
 663 wx.ListCtrl: patch #1210352, fixes editing in generic wx.ListCtrl with
 664 wx.LC_EDIT_LABELS.
 665
 666 Applied patch #208286, MediaCtrl DirectShow rewrite.
 667
 668 DocView patches from Morgan Hua: bug fixes, and additional SVN
 669 commands, also added a default template that uses the text editor for
 670 any unknown file type.
 671
 672 wxMSW: Use the system IDC_HAND cursor for wx.CURSOR_HAND and only fallback
 673 to the strange wxWidgets version if the system one is not available.
 674
 675 wx.grid.Grid: Merge the cell size attribute the same way that other
 676 attributes are merged, e.g., if it is already set to a non-default
 677 value in the current GridCellAttr object then don't merge from the
 678 other.
 679
 680 wx.lib.evtmgr: Fixed to use wx._core._wxPyDeadObject
 681
 682 wx.lib.gridmovers: Don't scroll when the mouse is dragged outside of
 683 the grid, unless the mouse is kept in motion.
 684
 685 wxMSW:  Applied patch #1213290 incorrect logic in
 686 wx.TopLevelWindow.ShowFullScreen.
 687
 688 Applied patch #1213066 correct device names for Joystick in Linux.
 689
 690 wxGTK: Applied patch #1207162 wx.TextCtrl.SetStyle fix for overlapping
 691 calls.
 692
 693 wx.FileConfig: fixed DeleteEntry to set the dirty flag properly so the
 694 change will get written at the next flush.
 695
 696
 697
 698
 699
 700 2.6.0.1
 701 -------
 702 * 30-May-2005
 703
 704 Added wx.BrushFromBitmap to create a stippled brush in a single step.
 705 Also added missing brysh style flags: wx.STIPPLE_MASK
 706 wx.STIPPLE_MASK_OPAQUE.
 707
 708 wxMSW: Fix for default control colours when the system text fg colour
 709 is not black.
 710
 711 wxGTK: Patch #1171754, It is now possible to have a menu item that
 712 both has an icon and is a submenu.
 713
 714 wxMSW: Patch #1197009, better refreshes when windows are moved and
 715 resized.
 716
 717 wxMSW: Patch #1197468.  Keeps track of pending size/position changes
 718 in case there is more than one adjustment for a window in a single
 719 DeferWindowPos set, then the pending values can be used for defaults
 720 instead of current values.
 721
 722 Fixed the typemap that converts a Python list of strings to a
 723 wxArrayString so it uses the wxPython default encoding.
 724
 725 Several docstrings added and updated.  Lots more to go.
 726
 727 wxMac: Strings added to the clipboard or used in DnD no longer have an
 728 extra null character at the end.
 729
 730 Added wx.GetXDisplay that returns a raw swigified pointer for the X11
 731 Display, or None for the non-X11 platforms.
 732
 733 wxMenu: Don't send an event when selecting an already selected radio
 734 item.
 735
 736 Added wx.LaunchDefaultBrowser.
 737
 738 wxMSW: Fixed erroneous selection of content in wx.ComboBox when within
 739 a wx.StaticBox.
 740
 741 wxMSW: Fixed alpha blitting to take into account source position.
 742
 743 Ensure that Python is still in an initialized state before doing any
 744 locking or unlocking in wxPyBeginBlockThreads and wxPyEndBlockThreads
 745 as these can be triggered after Python has been finalized in embedding
 746 situations.
 747
 748 Added alternate constructors for wx.Font: wx.FontFromPixelSize,
 749 wx.FFont, wx.FFontFromPixelSize.  See the docstrings or new api docs
 750 for details.
 751
 752 Added wx.lib.hyperlink from Andrea Gavana.  It is a control like
 753 static text that acts like a hyper-link, launching the system's
 754 default browser in response to the clicks.
 755
 756 Added an optional parameter to wxversion.select that allows you to
 757 specify that the extra components specified in the version string are
 758 required.  For example, if you ask for "2.6-unicode" but only the ansi
 759 version is installed then by default the ansi version will be selected
 760 as it considered close enough since the version numbers match.  If you
 761 want to force the options to be required then you can just add a True
 762 parameter, like this::
 763
 764          import wxversion
 765          wxversion.select("2.6-unicode", True)
 766          import wx
 767
 768 Tweaked wx.lib.buttons such that flat buttons (e.g. have no bevel and
 769 a wx.BORDER_NONE style flag) paint themed backgrounds if there are
 770 transparent areas and the parent is displaying a theme.
 771
 772 wxMSW:  Fix for wrong sash colour of wx.SplitterWindow in the silver
 773 theme on XP.
 774
 775 Added a wx.xrc.XmlResourceHandler for the Ticker class.  See
 776 wx/lib/ticker_xrc.py
 777
 778 wxSTC: Fixed CmdKeyAssign key bindings for Ctrl-Backspace.
 779
 780 wxMSW: Fixed a bug in wx.TextCtrl where all the lines were being used
 781 to calculate the best size, instead of using a reasonable limit.
 782
 783 XRCed: Use wx.GetDefaultPyEncoding/wx.SetDefaultPyEncoding for
 784 changing active encoding.  Fixed pasting siblings (Ctrl key pressed
 785 while pasting).
 786
 787 wx.lib.filebrowsebutton: Bug fix from Chad Netzer for when
 788 self.history is None.
 789
 790 wx.ogl: Patch from Davide Salomoni that adds an optional point
 791 parameter to LineShape.InsertLineControlPoint allowing one to
 792 optionally specify where the new control point has to be drawn.
 793
 794 wxMSW: setting foreground colour for wx.CheckBox now works when using
 795 XP themes.
 796
 797 More updates to the docview library modules and sample apps from the
 798 ActiveGrid folks.  Their sample IDE is now able to integrate with
 799 Subversion.
 800
 801 wx.grid.Grid:  Ensure that the grid gets the focus when it is
 802 left-clicked.  Note that if you have custom widgets that handle the
 803 EVT_LEFT_DOWN event but do not call event.Skip() then you will
 804 probably want to add a call to self.SetFocus in the event handler.
 805
 806 wxGTK:  Add wxSTAY_ON_TOP support [Patch 1206023]
 807
 808 wx.TreeCtrl:  wx.EVT_TREE_ITEM_MENU event made consistent on all
 809 platforms.  The location of the click or the item is included in the
 810 event as well.
 811
 812 wxGTK: Setting background colour of a window now only affects the
 813 window itself, not the borders, scrollbars, etc.  (Bug #1204069)
 814
 815 Print framework:  Add more paper sizes and code to fallback to an
 816 explicit paper size if a known paper size is not found for the
 817 printer.
 818
 819 wxMac: Applied patch for bug #1206181 Option-key decodes are wrong,
 820 also applied patch for bug #1205691 Modified Fn keys don't work.
 821
 822 wx.Image: Fixed to preserve alpha channel in Rotate90 method.
 823
 824 wxMSW: Fixed incorrect background colour on wx.CheckListBox.
 825
 826 wxMSW: Fixed drawing of owner drawn buttons with multiline labels
 827
 828 Removed a bunch of unnecessary files, and removed or replaced images
 829 that we're not sure of their origin or license.
 830
 831 The default DoGetBestSize is updated to not always return the current
 832 size if the window has no sizer, children, or minsize set.  Instead
 833 the current size is set as the minsize.  This solves the occasional
 834 problem where a sizer may cause a childless panel to grow but never
 835 shrink.
 836
 837 wxMSW: When converting a wx.Icon to a bitmap check if the icon has an
 838 alpha channel and set the bitmap to use it.
 839
 840 Fixed the wrong class name used in wx.PyScrolledWindow's call to
 841 _setCallbackInfo.
 842
 843 wxMSW: patch #1207202, Fixes GDI leak when using stock cursors.
 844
 845 wx.calendar.CalendarCtrl: Patch #1207531, Keeps the CalendarCtrl wide
 846 enough even when the weekday names for the locale are shorter than
 847 usual.
 848
 849 Made GridCellNumberEditor.StartingKey also insert the typed char when
 850 there is a range of allowed values (so a wx.SpinCtrl is used instead
 851 of a wx.TextCtrl.)
 852
 853
 854
 855
 856
 857 2.6.0.0
 858 -------
 859 * 26-Apr-2005
 860
 861 wxMSW: Fixed wx.TransientPopupWindow (and therefore wx.TipWindow) to
 862 auto-dismiss when the mouse is clicked outside of the popup like it is
 863 supposed to.
 864
 865 wxMSW: Fixed bug #1167891 wx.Notebook display problem with wx.NB_MULTILINE.
 866
 867 wxMSW: Fixed bad cliping of hidden windows inside of wx.StaticBox.
 868
 869 wxGTK:  The configure flags for selecting GTK+ 1.2.x or 2.x has
 870 changed slightly.  It is now --with-gtk[=VERSION] where VERSION is
 871 either '1', '2' or 'any'.  The default is '2'.
 872
 873 wx.stc.StyledTextCtrl: Added the following methods for alternate ways
 874 to set and fetch text from the document buffer.  They work similarly
 875 to the existing methods of the same name, except that they don't go
 876 through the same string/unicode <--> wxString conversions.  The "Raw"
 877 methods will do no conversions at all and in a unicode build of
 878 wxPython the strings will be in the utf-8 encoding and in an ansi
 879 build no assumption is made about the encoding.  The "UTF8" functions
 880 will attempt to always get/set utf-8 text, which it will always be
 881 able to do in a unicode build, and in an ansi build it will depend on
 882 the content of the utf-8 used being compatible with the current
 883 encoding, (you'll get an exception otherwise.)
 884
 885       ===================  ====================
 886       AddTextRaw           AddTextUTF8
 887       InsertTextRaw        InsertTextUTF8
 888       GetCurLineRaw        GetCurLineUTF8
 889       GetLineRaw           GetLineUTF8
 890       GetSelectedTextRaw   GetSelectedTextUTF8
 891       GetTextRangeRaw      GetTextRangeUTF8
 892       SetTextRaw           SetTextUTF8
 893       GetTextRaw           GetTextUTF8
 894       AppendTextRaw        AppendTextUTF8
 895       ===================  ====================
 896
 897
 898 wx.stc.StyledTextCtrl:  Added the StyleSetFontEncoding(style, enc)
 899 method that allows you to set the encoding to be used by the font for
 900 a particular style.
 901
 902 wxMac: Fixed wx.ComboBox to forward the EVT_CHAR, EVT_KEY_DOWN,
 903 EVT_KEY_UP and EVT_TEXT events from its embedded text control.
 904
 905 wxMac: Corrected refresh bugs in wxGrid.
 906
 907 XRCed: Updated to version 0.1.5.
 908     * Added wxWizard, wxWizardPageSimple (only from pull-down menu).
 909     * Hide command for test window.
 910     * Replacing classes works better.
 911     * Added Locate tool.
 912
 913
 914
 915
 916 2.5.5.1
 917 -------
 918 * 8-Apr-2005
 919
 920 wxMSW: Fixed bug #1022383, 'several ComboBoxes appear selected'
 921
 922 wx.grid.Grid: Fixed bug #1163384.  Moved the code that handles
 923 activating the cell editors to a EVT_CHAR event handler.  This is done
 924 so the character inserted into the editor will be the "cooked" char
 925 value (including accented or composed keys) rather than the raw code
 926 provided by the EVT_KEY_DOWN event.
 927
 928 Added orient parameter to wx.MDIParentFrame.Tile()
 929
 930 wxMSW: wxTextCtrl with wx.TE_RICH2 style now uses RichEdit 4.1 if
 931 available.
 932
 933 Added GetCount, GetCountRGB, and GetCountColour methods to
 934 wx.ImageHistogram.
 935
 936 wxMSW: wx.Window.Refresh changed to explicitly refresh all children as
 937 well as the parent.  Previously it was implicitly done because parents
 938 did not clip their children by default.  Now that they always clip
 939 children then Refresh needed to be fixed to do a recursive refresh.
 940 This also fixes the Freeze/Thaw problems that some people had with
 941 2.5.4.1.
 942
 943 wx.SplitterWindow: Send EVT_SPLITTER_SASH_POS_CHANGED only once after
 944 end of dragging and not after each CHANGING event (modified patch
 945 #1076226)
 946
 947 wx.glcanvas.GLCanvas: applied patch fixing problems with X server
 948 crash when using nVidia cards (patch 1155132)
 949
 950 wx.lib.mixins.listctrl: Patches from Toni Brkic:
 951    * Bugfix for TextEditMixin when the view can't be scrolled
 952    * Enhancement for ListCtrlAutoWidthMixin, allowing it to manage
 953      the width of any column.
 954
 955 wxMac: removal and reusing toolbar tools like the other platforms is
 956 now possible.
 957
 958 wxMac: Correct radio tool selection after calling Realize a 2nd time.
 959
 960 wxMSW: Applied patch #1166587, removes all flicker from wx.StaticBox
 961
 962 Added wx.lib.foldpanelbar, Andrea Gavana's port of Jorgen Bodde's C++
 963 wxFoldPanelBar classes to Python.
 964
 965 wxGTK: Applied patch #1173802, reimplementation of GtkFileChooser
 966 wxFileDialog by Mart Raudsepp.  Note that this new file dialog is only
 967 used on GTK2 >= 2.4.  For earlier GTK2 versions and GTK1 then the
 968 older generic file dialog is used.
 969
 970 wxMSW: fixes to static box borders calculations (finalizes patch
 971 #1166587)
 972
 973 wx.Image: Use Python's buffer interface API for all image data and
 974 alpha Set/Get methods and the ImageFromData* constructors.  They all
 975 still copy the buffer except for SetDataBuffer and SetAlphaBuffer, but
 976 this gives more flexibility on where the data can come from.
 977
 978 Added MDI support to XRC
 979
 980 Added wx.animate module and a demo.  The wx.animate module provides a
 981 control that is able to display an animated GIF file.
 982
 983 wx.lib.plot.py: Applied patch from Werner F. Bruhin that allows either
 984 vertical and/or horizontal gridlines.
 985
 986 wxMSW: Extra space given for top border of wx.StaticBoxSizer so the
 987 upper line is not cliped when there is no label.
 988
 989 wxMSW: Restored old behaviour of wx.StaticBox.SetBackgroundColour only
 990 affecting the label.
 991
 992 wxMSW: Fixed missing EVT_RIGHT_DOWN and EVT_TREE_ITEM_RIGHT_CLICK
 993 events in a wx.TreeCtrl.
 994
 995 Added wx.GetTopLevelWindows() function which returns a copy of the
 996 list of top-level windows that currently exist in the application.
 997
 998 Updated docview library modules and sample apps from the ActiveGrid
 999 folks.
1000
1001 Added the ActiveGrid IDE as a sample application.
1002
1003
1004
1005
1006 2.5.4.1
1007 -------
1008 * 16-Mar-2005
1009
1010 wx.Sizer Add, Insert, and Prepend functions now return a reference to the
1011 wx.SizerItem that was added to the sizer, and the wx.SizerItem has a
1012 GetRect accessor to give the position of the item on the parent window.
1013
1014 Added wx.Sizer.GetItem method which returns the wx.SizerItem for the given
1015 wx.Window, wx.Sizer or position index.
1016
1017 wxMSW: wx.RadioButtons in the same group no longer have to be
1018 consecutive (there may be intervening controls). Without this fix, an
1019 out-of-sync assert is generated when clicking on a radio button and
1020 then calling GetValue().
1021
1022 Some XRC changes:
1023     - Added 'icon' property to wxFrame and wxDialog
1024     - No longer ignores menu bitmaps on non-MSW platforms
1025     - Notebook page bitmaps are now supported
1026     - added system colours and fonts support (based on patch #1038207)
1027
1028 wxMSW: fix for [ 1052989 ] TextCtrl.SetBackgroundColour(wx.NullColour)
1029 bug.
1030
1031 Added wx.PasswordEntryDialog analagous to wx.TextEntryDialog, allows
1032 detecting entering an empty string vs. cancel unlike the
1033 wx.GetPasswordFromUser dialog function.
1034
1035 OGL patch from Shane Holloway:
1036
1037     Two simple problems found in the new python ogl code.  First is
1038     the patch for _canvas.py.  Essentially::
1039
1040         dx = abs(dc.LogicalToDeviceX(x - self._firstDragX))
1041         dy = abs(dc.LogicalToDeviceY(y - self._firstDragY))
1042
1043     was incorrect because (x,y) and (self._firstDragX,
1044     self._firstDragY) are both already in Logical coordinates.
1045     Therefore the difference between the two is also in logical
1046     coordinates, and the conversion call is an error.  This bug
1047     surfaces when you have OGL on a scrollwin, and you are far from
1048     the origin of the canvas.
1049
1050     The second change in _composit.py basically removes the assumption
1051     that the child is in both self._children and self._divisions.
1052     Causes many problems when it's not.  ;)
1053
1054 Fixed GetSaveData and SetSaveData in wx.lib.multisash to not depend on
1055 the default way that class objectss are converted to strings.
1056
1057 Fixed problem in StyledTextCtrl.Set[HV]ScrollBar that could leave the
1058 internal scrollbar visible.
1059
1060 Added wx.StandardPaths which provides methods for determining standard
1061 system paths for each platform.
1062
1063 wxMSW: The window background is now only erased by default if the
1064 background colour or background mode has been changed.  This better
1065 allows the default system themed behaviour to show through for
1066 uncustomized windows.  Explicit support added for using the correct
1067 theme texture for wx.Notebook pages and their children.
1068
1069 wx.Image: Added support for alpha channels in interpolated and
1070 non-interpolated image rotation.  Added ConvertAlphaToMask helper
1071 method for turning shades of grey into shades of alpha and a colour.
1072
1073 wxGTK2: Reimplemented DoDrawRotatedText() by way of a rotation of an
1074 alpha blended text bitmap.  It would be better if Pango could draw
1075 directly into an wxImage (as FreeType can,) but that is for later...
1076
1077 Added wrappers and a demo for the wx.MediaCtrl class, which can play
1078 various forms of audio/video media using native codecs install on the
1079 system.  So far it is only implemented for Windows and OSX.
1080
1081 wxGTK: Patch applied for Freeze()/Thaw() for wxTextCtrtl.
1082
1083 Added "gravity" for splitter window (patch 1046105). Gravity is a
1084 floating-point factor between 0.0 and 1.0 which controls position of
1085 sash while resizing the wx.SplitterWindow.  The gravity specifies
1086 how much the left/top window will grow while resizing.
1087
1088 wxMSW: wx.Slider's C++ implementation rewritten to be more
1089 maintainable and hopefully less buggy.  The position of the labels has
1090 also been changed in order to better comply with Microsoft's examples
1091 of how to use the control.
1092
1093 wxMSW:  Fix wx.TreeCtrl to end label editing if the control loses
1094 focus (a slightly modified patch 1084592.)
1095
1096 Added wx.EXEC_NODISABLE flag for wx.Execute, which will prevent all
1097 the app's windows being disabled while a synchronous child process is
1098 running.
1099
1100 wxMSW: Much work to correct painting (or leaving transparent) of
1101 control backgrounds, properly using background themes on XP, etc.
1102
1103 Fixed a circular reference problem with wx.Timer.  It will now
1104 completely cleanup after itself when the last reference to the timer
1105 is removed.  If you were previously using timer.Destroy() to cleanup
1106 your timers it will no longer work.  Instead you should hold a
1107 reference to the timer and then del the reference when you are
1108 finished with the timer.
1109
1110 Updated to 1.3.24 of SWIG.  All of my big patches have been applied to
1111 the main SWIG source tree, but unfortunatly there were also some bugs
1112 added that affected the wxPython build and a few details in my
1113 original patch were changed/removed, so we are still not free of
1114 patches.  A new patch for SWIG is located in the wxPython/SWIG
1115 directory of the wxPython source tree.  SWIG 1.3.24 plus this patch
1116 should be used by anyone who is making custom modifications to
1117 wxPython's .i files, or building their own extension modules or
1118 etc. that need to interact with the wxPython swigged types.  For the
1119 morbidly curious, here are a few more details:
1120
1121     * Since it is now possible easily and simply share the SWIG type
1122       tables across modules I reverted to always using the stock SWIG
1123       runtime instead of my slightly hacked up version of it exported
1124       via the wxPython C API.
1125
1126     * The %name directive is now deprecated so I replaced most uses of
1127       it with a custom %Rename macro that uses %rename internally.
1128       These will evetually need to be replaced with a DocDecl macro
1129       when docstrings are added for those items.
1130
1131     * The "this" attribute of all SWIGged classes is no longer a
1132       string containing a "swigified pointer", but rather a custom
1133       built-in type that holds the real C pointer to the object and
1134       the type info.  It can be converted to a string like the old
1135       value using str() or to the long integer value of the pointer
1136       using long().
1137
1138 Added SetDefaultPyEncoding and GetDefaultPyEncoding functions which
1139 will set/get the encoding used by wxPython to convert string or
1140 unicode objects to/from wxString objects.  Previously the default
1141 Python encoding was always used, but unless the user had tweaked their
1142 sitecustomize.py file it is always "ascii", which would result in
1143 errors if the strings contained character codes >= 128.
1144 SetDefaultPyEncoding will now allow you to control which encoding will
1145 be used to do those conversions.  The default encoding is set to the
1146 value of `locale.getdefaultlocale()[1]` when wxPython is first
1147 imported.  Please see http://www.alanwood.net/demos/charsetdiffs.html
1148 for information on the differences between the common latin/roman
1149 encodings.
1150
1151 Added wxStdDialogButtonSizer, which is a a special sizer that knows
1152 how to order and position standard buttons in order to conform to the
1153 current platform's standards.  You simply need to add each `wx.Button`
1154 to the sizer, and be sure to create the buttons using the standard
1155 ID's.  Then call `Realize` and the sizer will take care of the rest.
1156
1157 wxMSW Toolbar: pass correct tool id (and not always -1) to the
1158 EVT_TOOL_RCLICKED handler
1159
1160 wxGTK: Applied patch for combo box SELECTED events (no longer get
1161 lots of surplus events)
1162
1163 wxGTK: Applied patch for proper menu highlight colour detection in
1164 wx.SystemSettings.
1165
1166 wxGTK: Commited scrollbar patch #1093339 which sends lineup, linedown
1167 events based on intercepting the mouse down events.
1168
1169 wxGTK: Applied patch #1102789 which solved conflicts between wxWidgets
1170 and GTK+'s context menu code.
1171
1172 wxGTK: Applied patch #1100327 for correct feedback from DND actions
1173 (not all actions are allowed).
1174
1175 Fixed memory leak in wxGrid::UpdateAttr[Rows][Or][Cols] (patch 1104355)
1176
1177 For efficiency reasons, text controls no longer set the string for
1178 each text updated event, but rather query for the string value only
1179 when GetString is called from an event handler.
1180
1181 Added wx.SL_INVERSE style which will cause wx.Slider to invert the min
1182 and max ends of the slider.
1183
1184 Several patches applied, such as #1111174, #1110252 and others, that
1185 make the generic wx.TreeCtrl (used on wxGTK and wxMac) be more
1186 conistent with the wxMSW native wx.TreeCtrl.
1187
1188 XRCed:
1189     * Edit->Locate command (Ctrl-L) for quick selection of items.
1190       Works with event-handling controls (buttons, text fields) but
1191       not with labels/sizers.
1192     * Some improvements: relative paths for files supplied as command-
1193       line argument work correctly, notebook panels are highlighted
1194       better.
1195
1196 wxMac: Fixed a long-standing issue where wxSlider controls with a
1197 hardcoded size would misplace their labels behind the slider control.
1198
1199 wx.HtmlListBox fixed so calling RefreshLine(s) will cause the data for
1200 that line to be refetched from the overridden methods in the derived
1201 class.
1202
1203 The default DoGetBestSize now includes the difference (if any) between
1204 the client size and total size of the window, (such as the size of
1205 borders.)  Code that sets the client size using the best size, or that
1206 added extra space to sizers to compensate for this bug may need to be
1207 changed.
1208
1209 Can suppress themed notebook pages with the wxNB_NOPAGETHEME style or
1210 setting system option msw.notebook.themed-background to 0.
1211
1212 wxSyledTextCtrl updated to use Scintilla 1.62.
1213
1214 Can now set the msw.window.no-clip-children system option to 1 to
1215 eliminate weird refresh behaviour (delays between a window being
1216 erased and repainted, giving a ghostly gradual-redraw effect). May be
1217 a temporary 'fix' until properly fixed before 2.6.
1218
1219 wxMac:  Toolbar is now more native looking with borderless toolbar
1220 buttons.
1221
1222 wxMac: Switched wx.Bitmap to use newer Quartz object types and APIs
1223 internally.  This results in faster display and better alpha support.
1224
1225 Added wx.DatePickerCtrl.
1226
1227 wx.html.HtmlWindow now supports background images.
1228
1229 Added wx.lib.gestures module from Daniel Pozmanter which supports
1230 using Mouse Gestures in an application.
1231
1232 wxGTK2: ENTER and LEAVE mouse events are now sent for multi-line text
1233 controls.
1234
1235 wxMSW:  "Alt" key (VK_MENU) now results in WXK_ALT keyboard event, not
1236 WXK_MENU
1237
1238 Added modules from Peter Yared and Morgan Hua that implement the wx
1239 Doc/View framework in pure Python code.  See wx.lib.docview for the
1240 base implementation and wx.lib.pydocview for Python-specific
1241 extensions.  There are also a couple sample applications located in
1242 samples/docview.
1243
1244 Added GetBitmap, GetIcon to wx.ImageList.
1245
1246 wxGTK wx.Button.SetLabel no longer invalidates/resets the font.
1247
1248 wx.Sizer.AddWindow, AddSizer, AddSpacer and etc. have now been
1249 undeprecated at the request of Riaan Booysen, the Boa Constructor team
1250 lead.  Boa needs them to help keep track of what kind of item is being
1251 managed by the sizer.  They are now just simple compatibility aliases
1252 for Add, and etc.
1253
1254 The old C++ version of the OGL lib is no longer built by default.  Use
1255 the Python version in the wx.lib.ogl package instead.
1256
1257 The wx.iewin module is no longer built by default.  You can use the
1258 wx.lib.iewin version instead.
1259
1260 Fixed wx.BufferedPaintDC for scrolled windows to work whether the
1261 buffer is covering only the client area or the full virtual area of
1262 the scrolled window.  By default it will assume that only the client
1263 area is covered.  This is different than the old behavior so to
1264 indicate that the entire virtual area is covered simply add a
1265 style=wx.BUFFER_VIRTUAL_AREA parameter.
1266
1267 wx.gizmos.TreeListCtrl:  Add support for the EVT_TREE_ITEM_GETTOOLTIP
1268 event.
1269
1270 Added Resize, SetRGBRect, Size, and GetOrFindMaskColour methods to
1271 wx.Image.
1272
1273 Added wx.Rect.IsEmpty
1274
1275 wxGTK:
1276     - Corrected wx.ListBox selection handling
1277     - Corrected default button size handling for different themes
1278     - Corrected splitter sash size and look for different themes
1279     - Fixed keyboard input for dead-keys
1280
1281
1282
1283
1284 2.5.3.1
1285 -------
1286 * 9-Nov-2004
1287
1288 wxMac focus and border refreshes corrected.
1289
1290 Updated internal PNG library.
1291
1292 wxMac fix for metal appearance on wx.ToolBar.
1293
1294 wx.grid.Grid fix allowing DoGetBestSize to be called before CreateGrid
1295 (which means that a min size doesn't need to be specified.)
1296
1297 wxMac fix for not sending a native click to a control if it is not
1298 enabled (does an enable itself)
1299
1300 Added wx.lib.ogl.DrawnShape, and fixed various little bugs in the new
1301 OGL.
1302
1303 Added support to XRC and XRCed for the 3-state checkbox flags and also
1304 for wx.ToggleButton.  Updated the generic window styles supported by
1305 XRCed.
1306
1307 It is now possible to create "stock" buttons.  Basically this means
1308 that you only have to provide one of the stock IDs (and either an
1309 empty label or a label that matches the stock label) when creating the
1310 button and wxWidgets will choose the stock label to go with it
1311 automatically.  Additionally on the platforms that have a native
1312 concept of a stock button (currently only GTK2) then the native stock
1313 button will be used.  For example, the following will result in a
1314 button with "Cancel" as the label and if run on wxGTK2 then there will
1315 also be an image of a red X::
1316
1317        b = wx.Button(parent, wx.ID_CANCEL)
1318
1319
1320 Added wx.lib.ticker.Ticker class from Chris Mellon.
1321
1322 Fix some incorrect clipping regions in wxSTC on wxGTK.
1323
1324 Added wrapper for wx.grid.Grid.GetOrCreateCellAttr.
1325
1326 Removed my copy of distutils from the wxPython source tree.  Now that
1327 I am no longer doing builds on Python 2.1 the newest distutils is no
1328 longer needed.  (There is still one small bug in Python 2.2 distutils
1329 on win32, but it is easily worked around.) This sovles the problem of
1330 incorrect builds on some systems where the system installed distutils
1331 has been patched to behave slightly differently, for example SuSE on
1332 x86_64 or Chandler's build.
1333
1334 Updated to SWIG 1.3.22 (plus my patch.)  See wxPython/SWIG/README.txt
1335 in the source tree if you need to use SWIG when building your own copy
1336 of wxPython, or other extension modules that need to integrate with
1337 the wxPython modules.
1338
1339 Added wx.Frame.RequestUserAttention which, if the platform suports it,
1340 will do something (such as flash the task bar item) to suggest to the
1341 user that they should look at that window.
1342
1343 "Fixed" wx.grid.Grid.SetDefaultEditor and SetDefaultRenderer by making
1344 them register the editor or renderer for the "string" data type.
1345
1346 Added depth param to wx.Image.ConvertToBitmap.
1347
1348 Extended the wx.calendar.CalendarCtrl class with methods that get/set
1349 a Python datetime or date object.  (These will only work with Python
1350 2.3+) The methods are PySetDate, PyGetDate, PySetLowerDateLimit,
1351 PySetUpperDateLimit, PySetDateRange, PyGetLowerDateLimit, and
1352 PyGetUpperDateLimit.  Also, CalendarEvent was extended with PySetDate
1353 and PyGetDate methods.
1354
1355 wxMSW: SetBackgroundColour on a wx.Choice or a wx.ComboBox will now
1356 also set the colour of the dropdown.
1357
1358 wxMac: MessageDialog now supports wx.NO_DEFAULT style
1359
1360 wxMSW: added AssociateHandle and DissociateHandle to wx.Window
1361
1362 wxMac: fix for toolbar tooltips
1363
1364 wx.Sizer.Show (and Hide) now take an optional parameter specifying if
1365 the item to be shown should be searched for recursivly in subsizers,
1366 and return a boolean value indicating if the item was found.
1367
1368 wxMSW: fixed MaximizeEvent generation in wx.Frame
1369
1370 wxMSW: fixed sending duplicate EVT_COMBOBOX events
1371
1372 Smoother time estimation updates in wx.ProgressDialog (patch 992813)
1373
1374 Made wx.Listbook events more consistent with wx.Notebook ones (patch
1375 1001271)
1376
1377 Fixed rounding errors in variable status bar panes widths computation
1378 (patch 1030021)
1379
1380 Added possibility to specify printer bin (patch 910272)
1381
1382 wxMSW: fixed wx.ListCtrl's SetWindowStyleFlag() to not remove
1383 WS_VISIBLE; also refresh the control automatically (closes bug
1384 1019440)
1385
1386 Added wx.Choicebook, yet another notebook-like control.
1387
1388 wxMSW: Make radiobutton tab behaviour the same on MSW as in standard
1389 MSW app, i.e. tab into the activated, not necessarily the first radio
1390 button.
1391
1392 Added limited support for wxEventLoop (you can't derive from a
1393 wx.PyEventLoop version yet...)  Updated and moved the sample showing
1394 how to replace the MainLoop to samples/mainloop/mainloop.py.
1395
1396 The C++ xrc lib has been moved out of contrib and into the core, so it
1397 is always built by default.  wxPython's build has also changed
1398 accordingly and will build the xrc module as part of the core set of
1399 modules built by default.  If you were axplicitly using BUILD_XRC then
1400 it will no longer be recognized as a build option, otherwise you
1401 should notice no difference.
1402
1403 wxMac: Fixed radio toolbar buttons to correctly untoggle the others
1404 when a new one is selected.
1405
1406 wxMac: Fixed GetLineLength and GetLineText for MLTE text controls
1407
1408 wxMac: wx.TaskBarIcon is implemented by allowing you to change the
1409 app's icon on the Dock and also specifying a menu that should be
1410 merged with the normal dock popup menu.  See the MigrationGuide for
1411 more details and a warning.
1412
1413 Added wx.TopLevelWindow.IsActive() which tells you if the frame or
1414 dialog is or containts the active window with the keyboard focus.
1415
1416 Added ability to create a font based on pixel size rather than point
1417 size via the FontFromPixelSize constructor.
1418
1419 Updated the Scintilla used by StyledTextCtrl to version 1.61
1420
1421 Improved image HitTest for TreeListCtrl.
1422
1423 Added wx.App.IsMainLoopRunning.
1424
1425 wxGTK: Make wxComboBox spit out a bit fewer surplus events when
1426 holding down the mouse button.
1427
1428 wxGTK: Enable key based navigation through notebook tabs as in the
1429 native control with Left and right keys. Support for vetoing.
1430
1431 FloatCanvas updates from Chris Barker
1432
1433 PyPlot updates from Gordon Williams:
1434    - Added bar graph demo
1435    - Modified line end shape from round to square.
1436    - Removed FloatDCWrapper for conversion to ints and ints in
1437      arguments
1438    - Imported modules given leading underscore to name.
1439    - Added Cursor Line Tracking and User Point Labels.
1440    - Demo for Cursor Line Tracking and Point Labels.
1441    - Size of plot preview frame adjusted to show page better.
1442    - Added helper functions PositionUserToScreen and
1443      PositionScreenToUser in PlotCanvas.
1444    - Added functions GetClosestPoints (all curves) and GetClosestPoint
1445      (only closest curve) can be in either user coords or screen
1446      coords.
1447
1448 MaskedEdit updates from Will Sadkin:
1449     - Added '*' mask char that means "all ansii chars" (ords 32-255)
1450     - Added proper unicode support to masked controls and wx.tools.dbg
1451     - Fixed two reported missing import bugs introduced by package
1452       creation
1453     - Converted masked package doc strings to reST format for better
1454       epydoc support
1455     - lots of doc string improvements and function hiding to better
1456       reflect package's public contents.
1457
1458 Restructured the installer packages slightly to help facilitate having
1459 multiple versions of wxPython installed at the same time.  See the
1460 Migrarion Guide for more information.
1461
1462 Applied patch from Pim Van Heuven that modifies 4 files:
1463     - wxPython/demo/ListCtrl_edit.py (new demo)
1464     - wxPython/demo/Main.py (include new demo in demo app)
1465     - wxPython/wx/lib/mixins/listctrl.py (several improvements to
1466       TextEditMixin)
1467     - wxPython/wx/lib/wxpTag.py (some small fixes)
1468
1469 Added (thanks to Kevin Ollivier!) wrappers for wx.WebKitCtrl for the
1470 OSX build.  Other platforms will raise an exception if you try to use
1471 it.
1472
1473 wxPython on OSX can now be built in Unicode mode, can support multiple
1474 version installs, and comes with an uninstaller script.
1475
1476
1477
1478
1479
1480 2.5.2.8
1481 -------
1482 * 27-Aug-2004
1483
1484 Predominantly a bug-fix release.
1485
1486   * Fixed fatal error due to improper wrapping of wx.FSFile.
1487
1488   * Fixed return type of EditableListBox.GetListCtrl
1489
1490   * Give generic tree and list controls a DoGetBestSize so they play
1491     nicer with sizers when there is no minimal size.
1492
1493   * Some tweaks in the demo and samples to correct layout, some
1494     flicker problems, and namespace use.
1495
1496   * Add wx.Image.ConvertAlphaToMask
1497
1498   * Minor corrections in wx.lib.dialogs
1499
1500   * wx.FileHistory constructor now accepts the documented 2nd
1501     parameter.
1502
1503   * Corrections for exceptions in the new ogl
1504
1505   * Fixed XRCed to not use reparenting of windows to implement caching
1506     of property panels, since Reparent on wxMac is not implemented.
1507
1508   * Add support for wxTAB_TRAVERSAL to the XRC handler for
1509     wxScrolledWindow.
1510
1511   * Add support for all wxListBox styles to the XRC handler for
1512     wxCheckListBox.
1513
1514   * Fix for wx.Listbook.DeleteAllPages to really delete everything.
1515
1516   * wxGTK2 now supports alpha blended bitmap drawing
1517
1518   * Made wx.grid.Grid play nicer with sizers.
1519
1520   * etc.
1521
1522
1523
1524
1525 2.5.2.7
1526 -------
1527 * 14-Aug-2004
1528
1529 wx.ADJUST_MINSIZE is now the default behaviour for window items in
1530 sizers.  This means that the item's GetMinSize and/or GetBestSize will
1531 be called when calculating layout and the return value from that will
1532 be used for the minimum size used by the sizer.  The wx.FIXED_MINSIZE
1533 flag was added that will cause the sizer to use the old behaviour in
1534 that it will *not* call the window's methods to determine the new best
1535 size, instead the minsize that the window had when added to the sizer
1536 (or the size the window was created with) will always be used.  Please
1537 see the Sizers section in the Migration Guide for more details.
1538
1539 Added new MaskedEditControl code from Will Sadkin.  The modules are
1540 now locaed in their own sub-package, wx.lib.masked.  Demos updated.
1541
1542 The changes that implemented the incompatible wx.DC methods in 2.5.1.5
1543 have been reverted.  The wx.DC methods are now compatible with the 2.4
1544 implemetation.  In addition a set of renamed methods have been added
1545 that take wx.Point and/or wx.Size objects instead of individual
1546 parameters.
1547
1548 Added wx.lib.mixins.listctrl.TextEditMixin, a mixin class that allows
1549 all columns of a wx.ListCtrl in report mode to be edited.
1550
1551 Deprecated the wx.iewin module.
1552
1553 Deprecated the wx.Sizer.AddWindow, AddSizer, AddSpacer methods as well
1554 as their Insert* and Prepend* counterparts.
1555
1556 Added a generic StaticBitmap class in wx.lib.statbmp for the same
1557 reasons that stattext was created, so it could be mouse sensitive on
1558 all platforms like normal windows.  Also updated stattext.py and
1559 buttons.py to handle attribute (font & colour) defaults and
1560 inheritance the new way.  If you have custom controls of your own you
1561 should review stattxt.py or one of the others to see how it is to be
1562 done.
1563
1564 wx.InitAllImageHandlers is now an empty function that does nothing but
1565 exist for backwards compatibility.  The C++ version is now called
1566 automatically when wxPython is initialized.  Since all the handlers
1567 are included in the wxWidgets shared library anyway, this imposes only
1568 a very small amount of overhead and removes several unneccessary
1569 problems.
1570
1571 Replaced wx/lib/pubsub.py with a version that uses weak references to
1572 track the subscribers, plus other fixes/additions.  Thanks go to
1573 Oliver Schoenborn and Robb Shecter.
1574
1575 wxGTK now uses gtk_init_check so wxPython can raise an exception if
1576 there is no DISPLAY available or other initializaion problem.
1577
1578 wx.GetKeyState now has an implementation for wxGTK and is able to
1579 detect the up/down or toggle state of modifier and toggle keys.
1580
1581 The LC_NUMERIC locale is now reset back to "C" (compatibility) when
1582 running on wxGTK to work around the fact that GTK requires the locale
1583 to be set to the system settings but Python depends on LC_NUMERIC
1584 remaining compatible with "C".
1585
1586 Switched gizmos.TreeListCtrl to the newer version of the code from the
1587 wxCode project.
1588
1589 OGL is dead! LONG LIVE OGL!  (Oops, sorry.  A bit of my dramatic side
1590 leaked out there...)  The wx.ogl module has been deprecated in favor
1591 of the new Python port of the OGL library located at wx.lib.ogl
1592 contributed by Pierre Hjälm.  This will hopefully greatly extend the
1593 life of OGL within wxPython by making it more easily maintainable and
1594 less prone to getting rusty as there seems to be less and less
1595 interest in maintaining the C++ version.  At this point there are just
1596 a couple minor known compatibility differences, please see the
1597 MigrationGuide_ file for details.
1598
1599 .. _MigrationGuide: MigrationGuide.html
1600
1601 EVT_STC_POSCHANGED has been removed as it has been deprecated in
1602 Scintilla for several releases now.
1603
1604 All the Window and GDI (pen, bitmap, etc.) class constructors and also
1605 many toplevel functions and static methods will now check that a
1606 wx.App object has already been created and will raise a
1607 wx.PyNoAppError exception if not.
1608
1609 Added more default args as needed to allow most window types to be
1610 constructed with only the parent window arg.  In some cases other args
1611 may be required for normal operation, but they can usually be set
1612 after construction.
1613
1614 Removed the deprecated ErrorDialogs and PythonBitmaps modules.  If you
1615 were using these in your apps then please join wxPython-dev and assist
1616 with a more modern reimplementation.
1617
1618 Added a new version (0.8.3) of FloatCanvas from Chris Barker.  It's now
1619 in a subpackage of wx.lib.
1620
1621 It is now possible to change the tab traversal order of controls on a
1622 panel or dialog.  For details see the new MoveAfterInTabOrder and
1623 MoveBeforeInTabOrder methods of wx.Window.
1624
1625 Applied (and heavily modified) a patch from Eugene
1626 <svip123@fastmail.fm> that allows the sample modules in the demo to be
1627 edited and reloaded, all from within the demo.  You can switch back
1628 and forth between the default and your edited version, and any errors
1629 ocurring upon the reload are reported on the Demo tab.
1630
1631 Added a menu item in the demo that will open a PyShell window that has
1632 the app and demo frame preloaded in the namespace.  This is another
1633 good way to explore and play with the objects in the currently running
1634 sample.  For example, load the Button sample and then do the following
1635 in the PyShell::
1636
1637         >>> b = frame.demoPage.GetChildren()[0]
1638         >>> for x in range(0, 500, 10):
1639         ...     b.Move((x, 50))
1640         ...     app.Yield(True)
1641         ...     wx.MilliSleep(10)
1642
1643
1644 wxGTK: Applied wxNO_BORDER patch (#1098374) for text control and combo
1645 box.
1646
1647
1648
1649 2.5.1.5    (the 'this is *not* a joke' release)
1650 -----------------------------------------------
1651 * 2-Apr-2004
1652
1653 (See also the MigrationGuide_ file for details about some of the
1654 big changes that have happened in this release and how you should
1655 adapt your code.)
1656
1657 .. _MigrationGuide: MigrationGuide.html
1658
1659
1660 The wxWindows project and library is now known as wxWidgets.  Please
1661 see http://www.wxwindows.org/name.htm for more details.  This won't
1662 really affect wxPython all that much, other than the fact that the
1663 wxwindows.org domain name will be changing to wxwidgets.org, so mail
1664 list, CVS, and etc. addresses will be changing.  We're going to try
1665 and smooth the transition as much as possible, but I wanted you all to
1666 be aware of this change if you run into any issues.
1667
1668
1669 Many, many little fixes, changes and additions done as part of the move
1670 to wxWidgets 2.5 that I have forgotten about.
1671
1672 Added wxMirrorDC.
1673
1674 Added wxIconLocation
1675
1676 Added Python wrappers and demos for the new wxVScrolledWindow,
1677 wxVListBox, and wxHtmlListBox classes.
1678
1679 Added wrappers for wxBookCtrl and wxListbook.  wxNotebook now derives
1680 from wxBookCtrl.
1681
1682 Added Gordon Williams' PyPlot module to the library, available as the
1683 wx.lib.plot module.
1684
1685 I made a small but important change in the code that aquires the
1686 Python Global Interpreter Lock to try and prevent deadlocks that can
1687 happen when there are nested attempts to aquire the GIL.
1688
1689 The RPMs will now install menu items on Mandrake Linux in
1690 Applications/Development/Tools for PyCrust, XRCed, etc.  The RPMs are
1691 also installing icons and ``*.desktop`` items in the generic KDE and
1692 GNOME locations, but I don't know yet if they are resulting in menu
1693 items on non-Mandrake systems.  (It didn't automatically do it on my
1694 RH-9 build box but I didn't chase it very far...)  If you have ideas
1695 for how to improve the .spec file to work better and/or on more
1696 distros please send me a patch.
1697
1698 The RPMs are now built on a fairly generic RH-9 box, and I have tested
1699 installing them also on my main Mandrake 9.2 box.
1700
1701 There are some big changes in the OS X disk image.  The actual
1702 Installer package now *only* installs the wxMac dynlibs, wxPython
1703 extension modules and Python packages, and also the command-line tool
1704 scripts. The remaining items (demo, samples, and application bundles
1705 for the Demo, PyCrust and XRCed) are now top-level items in the disk
1706 image (.dmg file) that users can just drag and drop to wherever they
1707 want to put them.
1708
1709 The wxWave class has been renamed to wxSound, and now has a slightly
1710 different API.
1711
1712 Updated the AnalogClockWindow with many enhancements from E. A. Tacão.
1713
1714 wxMac now has wx.ToggleButton!
1715
1716 wx.stc.StyledTextCtrl has been updated to version 1.58 of Scintilla.
1717
1718 To help with the wx.stc.StyledTextCtrl performance issues on wxMac
1719 I've added a SetUseAntiAliasing method (and GetUseAntiAliasing too)
1720 that will turn off the use of antialiased fonts in the wxSTC, allowing
1721 it to bypass the slow text measuring routines and use the fast and
1722 simple one instead.  By default the setting is turned off (on wxMac
1723 only.)  When run on OSX the Py* apps have a new item on the Options
1724 menu for controlling this setting if you would like to experiment with
1725 it.
1726
1727 Updated wx.lib.calendar with many fixes and enhancements from Joerg
1728 "Adi" Sieker.
1729
1730 Added wx.Display and wx.VideoMode.
1731
1732 AppleEvents can be handled by overriding wx.App methods MacOpenFile,
1733 MacPrintFile, MacNewFile, and MacReopenApp.
1734
1735 Added wx.PlatformInfo which is a tuple containing strings that
1736 describe the platform and build options of wxPython.  See the
1737 MigrationGuide for more details.
1738
1739 Created a new extension module "activex" from Lindsay Mathieson's
1740 newest wxActiveX_ class.  (The existing iewin module used an older
1741 version of this code, but only exposed the wxIEHtmlWin class.)  This
1742 new module will (in theory ;-) ) allow you to host arbitrary ActiveX
1743 controls in a wx.Window, **without** requiring the use of the win32com
1744 and other PyWin32 modules!  This should eliminate the cronic problems
1745 that have resulted from minor mismatches in how PyWin32 handles the
1746 GIL and tstate when making callbacks, etc.  The older iewin module
1747 will be left in this release as the new stuff is not fully backwards
1748 compatible, but you should migrate your code to the new IEHtmlWindow
1749 in wx.lib.iewin, so the old one can be eventually removed.
1750 Additionally, I've always considered that the wx.lib.activexwrapper
1751 module is an ugly hack that I only included in the lib because I
1752 couldn't figure out anything better.  Well now we have something that,
1753 if it isn't already, has the potential to be better.  So consider
1754 migrating away from using activexwrapper as well.  Please see the
1755 MigrationGuide for more details on using the new module.
1756
1757 .. _wxActiveX: http://members.optusnet.com.au/~blackpaw1/wxactivex.html
1758
1759 Floats are allowed again as function parameters where ints are expected.
1760
1761
1762
1763
1764 2.4.2.4
1765 -------
1766 * 1-Oct-2003
1767
1768 Use wxSTC in the demo for displaying the soucre code of the samples.
1769
1770 Lots of bug fixes and such from the wxWindows folks.
1771
1772 Added wxPython.lib.newevent from Miki Tebeka.  Its usage is
1773 demonstrated in the Threads sample in the demo.
1774
1775 Updates to wxMaskedEditCtrl.
1776
1777 Added wxMaskedNumCtrl.
1778
1779 Added Chris Barker's FloatCanvas.
1780
1781
1782
1783 2.4.1.2
1784 -------
1785 * 19-Jun-2003
1786
1787 Added wxScrolledPanel from Will Sadkin
1788
1789 Added SetShape method to top level windows (e.g. wxFrame.)
1790
1791 Changed wxSWIG to not generate Python code using apply, (since it will
1792 be deprecated in the future) wxSWIG will use ``spam(*args, **kw)`` syntax
1793 instead.  Also changed the generated __repr__ methods to be a bit more
1794 informative.
1795
1796 Made the version number information more robust and uh, informative.
1797 Also added asserts to check that the major.minor versions of wxPython
1798 and wxWindows match.
1799
1800 Added the new wx "renamer" package that will dynamically import from
1801 the wxPython package and rename wxFooBar --> FooBar.  That means that
1802 people can do imports without ``"import *"`` and can use names like
1803 wx.Frame instead of wx.wxFrame.  This is phase 1 of a full transition
1804 to the new namespace.
1805
1806 Updated Scintilla to 1.52.  I also changed it to use wxListCtrl
1807 instead of wxListBox for the AutoComplete window, added the ability to
1808 use custom bitmaps in the margin and in the AutoComplete windows, and
1809 worked out how to do proper clipping of child windows on wxGTK.
1810
1811 Patrick O'Brien's PyCrust package has been renamed to Py and now
1812 includes several new tools.  As part of the change the location of the
1813 pacakge has changed as well, it is now accessible as "from wxPython
1814 import py" (or "from wx import py" using the new namespace.)  There
1815 are still some transition modules in the wxPython.lib.PyCrust package
1816 that will issue a warning and then import what is needed from the new
1817 package.  These will be removed in a future release.
1818
1819 Added __nonzero__ method to wxTreeItemId, wxBitmap, wxImage, wxFont,
1820 and most other classes that have an Ok or IsOK method.  This allows
1821 code like "if obj: ..." to be the same as "if obj.IsOk(): ..."
1822
1823 Toolbars on wxMac can now have controls on them.
1824
1825 Added wxPython.lib.analogclock module based on samples that were
1826 passed back and forth on wxPython-users a while back.
1827
1828 Added masked edit controls (wxPython.lib.maskededit) by Jeff Childers
1829 and Will Sadkin.  Updated wxTimeCtrl to use MaskedEdit.
1830
1831 When the __class__ of a dead object is replaced with _wxPyDeadObject
1832 the __del__ of the original class is now called first.
1833
1834 Added wxTreeListCtrl.  (Looks like a wxTreeCtrl embedded in a
1835 wxListCtrl, but actually is just giving multiple columns to a
1836 wxTreeCtrl.)
1837
1838 Added wxFutureCall, a subclass of wxTimer that makes it easy to delay
1839 a call to any Python callable object.
1840
1841 Added wxPy versions of wxPrintPreview, wxPreviewFrame, and
1842 wxPreviewControlBar so they can be derived from in Python and be able
1843 to override the C++ virtual methods.
1844
1845 Simplified how the wxSizer methods are wrapped, changed the name of
1846 the "option" parameter to "proportion" to match the docs ("option" is
1847 still accepted for compatibility, but this will go away in a future
1848 release,) SetItemMinSize can now take a wxSize (or 2-tuple) parameter,
1849 and Spacers can be specified with a wxSize (or 2-tuple) parameter
1850
1851 Added wxCursorFromBits.
1852
1853
1854
1855
1856
1857 2.4.0.7
1858 -------
1859 * 24-Mar-2003
1860
1861 Gave up on generating a warning upon the use of the old true/false or
1862 TRUE/FALSE values.
1863
1864 Fixed wxGenericTreeCtrl (used on wxGTK and wxMac for wxTreeCtrl) so
1865 that it can successfully handle lots of nodes instead of overflowing
1866 when the virtual height of the widget overflowed a 16-bit value.
1867
1868 Fixed the typemap that converts strings to wxColours to also accept
1869 unicode.
1870
1871 Fixed problem where the wrong class name could sometimes be used for
1872 OOR.
1873
1874 Fixed an interpreter lock problem in the __eq__ and __ne__ methods in
1875 wxSize and etc.
1876
1877 Updated PyCrust to version 0.9
1878
1879 Instead of always logging C++ assertions, added wxPYAPP_ASSERT_LOG
1880 flag to turn it on.  In most cases turning it into an exception (the
1881 default behavior) is enough.  See below in the 2.3.4.1 notes for more
1882 details.
1883
1884
1885
1886
1887 2.4.0.6 (a.k.a. the I'm so stupid release)
1888 ------------------------------------------
1889 * 11-Mar-2003
1890
1891 The new deprecation class for the old true/false symbols can now be
1892 returned from OnInit.  And I promise to be sure I am testing what I
1893 think I am testing in the future...
1894
1895
1896
1897 2.4.0.5 (a.k.a. the blame it on Kevin release)
1898 ----------------------------------------------
1899 * 7-Mar-2003
1900
1901 A few little but annoying bug fixes.
1902
1903 Updated pycolourchooser.
1904
1905 Updated to 0.9b of PyCrust.
1906
1907
1908
1909 2.4.0.4
1910 -------
1911 * 7-Mar-2003
1912
1913 Added missing wxRect methods
1914
1915 Add OOR support for wxApp objects too.
1916
1917 Added wxCursorFromImage, which works on wxMSW and wxGTK so far.
1918
1919 All platforms now send EVT_DESTROY_WINDOW.  Be warned that at the time
1920 the event is sent the window is in the process of being deconstructed,
1921 and so calling some (most?) methods of the window itself may cause
1922 problems.
1923
1924 Fixed SF Bug #689481, a method in the OGL wrappers was using the wrong
1925 return type.
1926
1927 Fixed SF Bug #689958, an endless loop in printout.py.
1928
1929 Added EVT_WINDOW_CREATE_ID and EVT_WINDOW_DESTROY_ID so these events
1930 can be associated with a specific window ID and more easily caught by
1931 the parent window.
1932
1933 Fixed copy-paste error in wxListCtrl.GetFirstSelected.
1934
1935 Added missing Init method (and an overloading wrapper) to wxLocale
1936 wrapper.
1937
1938 Added a wxBitmap.SetMaskColour convenience method.
1939
1940 Changed how the dynamic event tables (used for all Python wx classes,
1941 C++ wx classes typically use static event tables) are searched such
1942 that they behave from a Python perspective more like the static tables
1943 in C++.  Namely that if there are identical event bindings in a base
1944 Python class and a derived Python class that the one in the derived
1945 class will be found first and that if Skip is called that the one in
1946 the base class will still be found instead of skipping directly to the
1947 static stable in the C++ class.
1948
1949 Switched to using True/False in the wxPython lib and demo instead of
1950 true/false or TRUE/FALSE to prepare for the new boolean type and
1951 constants being added to Python.  Added code to wx.py to test for the
1952 existence of the new constants and to create suitable values if not
1953 present.
1954
1955 Added some static wxApp functions that help with integration with the
1956 Mac UI.  They are no-ops on other platforms so it doesn't hurt to
1957 always call them.  The functions are::
1958
1959        wxApp_GetMacDefaultEncodingIsPC
1960        wxApp_GetMacSupportPCMenuShortcuts
1961        wxApp_GetMacAboutMenuItemId
1962        wxApp_GetMacPreferencesMenuItemId
1963        wxApp_GetMacExitMenuItemId
1964        wxApp_GetMacHelpMenuTitleName
1965        wxApp_SetMacDefaultEncodingIsPC
1966        wxApp_SetMacSupportPCMenuShortcuts
1967        wxApp_SetMacAboutMenuItemId
1968        wxApp_SetMacPreferencesMenuItemId
1969        wxApp_SetMacExitMenuItemId
1970        wxApp_SetMacHelpMenuTitleName
1971
1972 Refactored, enhanced and added capabilities for the DrawXXXList
1973 functions, inspired by code from Chris Barker.
1974
1975 The wxWindows .mo language catalog files are now installed in a
1976 subdirectory of the wxPython package dir on MSW since that platform
1977 doesn't have a standard place for them.
1978
1979 Added missing deselect methods for wxGrid.
1980
1981 Fixed typemaps for wxGridCellCoordsArray.
1982
1983 Updated to the 0.9a version of PyCrust
1984
1985
1986
1987 2.4.0.2
1988 -------
1989 * 23-Jan-2003
1990
1991 Several bug fixes.
1992
1993 Added wxIntCtrl from Will Sadkin.
1994
1995 Added wxPyColourChooser by Michael Gilfix.
1996
1997
1998
1999
2000 2.4.0.1
2001 -------
2002 * 10-Jan-2003
2003
2004 No major new features since 2.3.4.2, mostly bug fixes and minor
2005 enhancements.
2006
2007 Added function wrappers for the common dialogs from Kevin Altis.  See
2008 wxPython/lib/dialogs.py for more details.
2009
2010
2011
2012 2.3.4.2
2013 -------
2014 * 21-Dec-2002
2015
2016 Various bug fixes.
2017
2018
2019
2020 2.3.4.1
2021 -------
2022 * 18-Dec-2002
2023
2024 Updated XRCed and wxTimeCtrl contribs.
2025
2026 Show a couple new wxGrid features in the demo.
2027
2028 Several bug fixes in wxWindows.
2029
2030 Added wxHtmlFilter.
2031
2032 wxASSERT and related C++ runtime diagnostics are now converted to
2033 Python exceptions.  When an assert happens a wxPyAssertionError
2034 (which derives from AssertionError) exception is created and when
2035 control returns back to the Python code that invoked the C++ API it
2036 will be raised.  The same exception restrictions are in place as
2037 before, namely that exceptions can't cross from one Python layer
2038 through C++ to another Python layer.  That simply means that if you
2039 want to catch wxPyAssertionError or any other exception that you need
2040 to do it before control returns to C++ at the end of your event
2041 handler or callback code.  There is some test code in demo/wxButton.py
2042 you can use to play with this new feature.
2043
2044 Added some methods to wxApp (SetAssertMode and GetAssertMode) that let
2045 you control how C++ assertions are processed.  Valid modes are:
2046 wxPYAPP_ASSERT_SUPPRESS, wxPYAPP_ASSERT_EXCEPTION, and
2047 wxPYAPP_ASSERT_DIALOG.  Using _SUPPRESS will give you behavior like
2048 the old "final" builds and the assert will be ignored, _EXCEPTION is
2049 the new default described above, and _DIALOG is like the default in
2050 2.3.3.1 and prior "hybrid" builds.  You can also combine _EXCEPTION
2051 and _DIALOG if you wish, although I don't know why you would.
2052
2053 You can now overload OnInitGui, OnExit and OnAssert in your classes
2054 derived from wxApp.
2055
2056 Added GetSelectedCells, GetSelectionBlockTopLeft,
2057 GetSelectionBlockBottomRight, GetSelectedRows, GetSelectedCols nethods
2058 to wxGrid.
2059
2060 Added Python == and != operators for some basic classes
2061
2062 Fixed the Python wrappers for wxInputStream so they no longer block
2063 when reading from a wxProcess on wxGTK.  They now work more or less as
2064 they did before 2.3.3.1 but the dual meaning of eof() has been
2065 removed.  There is now a CanRead() method that lets you know if there
2066 is data waiting to be read from the pipe.
2067
2068 Fixed method name clash in wxIEHtmlWin, renamed Refresh to RefreshPage.
2069
2070 Added Throbber from Cliff Wells to the library and the demo.
2071
2072 Windows installer prompts to uninstall old version first.
2073
2074 Added wxPython.lib.evtmgr by Robb Shecter, which is an easier, more
2075 "Pythonic" and more OO method of registering handlers for wxWindows
2076 events using the Publish/Subscribe pattern.
2077
2078 Added wxPython.lib.popupctl by Gerrit van Dyk which is a combobox-like
2079 gizmo for poping up arbitrary controls.  It is currently using
2080 wxDialog because of some issues with wxPopupWindow...
2081
2082 Added wxPython.lib.gridmovers by Gerrit van Dyk which facilitates the
2083 dragging of columns and/or rows in a wxGrid.
2084
2085 Added wxPython.lib.multisash by Gerrit van Dyk which is a nice
2086 implementation of allowing the user to split a window any number of
2087 times either horizontally or vertically, and to close the split off
2088 windows when desired.
2089
2090 Added helpviewer tool that displays HTML books similarly to how MS
2091 HTMLHelp viewer does.  Changed how the wxPythonDocs tarball is built
2092 and added a script to launch the doc viewer.
2093
2094
2095
2096
2097 2.3.3.1
2098 -------
2099 * 19-Sep-2002
2100
2101 Added wxSplashScreen.
2102
2103 Added wxGenericDirCtrl.
2104
2105 Added wxMultiChoiceDialog.
2106
2107 The calltip window and autocomplete window in wxSTC will now use a
2108 wxPopupWindow if available on the platform (and functioning correctly)
2109 so they can extend beyond the client area of the STC if needed.
2110
2111 Finished wrapping and providing typemaps for wxInputStream and also
2112 added the stream ctor and other methods for wxImage so images can now
2113 be loaded from any Python "file-like" object.
2114
2115 Changed the img2py tool to use PNG instead of XPM for embedding image
2116 data in Python source code, and the generated code now uses streams to
2117 convert the image data to wxImage, wxBitmap, or wxIcon.
2118
2119 Added the wxPython.lib.rcsizer module which contains RowColSizer.
2120 This sizer is based on code from Niki Spahiev and lets you specify a
2121 row and column for each item, as well as optional column or row
2122 spanning.  Cells with no item assigned to it are just left blank.
2123 Stretchable rows or columns are specified and work the same as in
2124 wxFlexGridSizer.
2125
2126 Updated XRCed from Roman Rolinsky
2127
2128 Added wxBufferedDC.
2129
2130 Upgraded wxSTC from Scintilla 1.40 to Scintilla 1.45, and then again
2131 to version 1.47, and one more time to 1.48! <wink>
2132
2133 UNICODE!
2134     wxWindows/wxPython can be compiled with unicode support enabled or
2135     disabled.  Previous to wxPython 2.3.3 non-unicode mode was always
2136     used.  Starting with 2.3.3 either mode is supported, but only if
2137     it is also available in wxWindows on the platform.  Currently
2138     wxWindows only supports unicode on MS Windows platforms, but with
2139     the recent release of GTK+ 2.0 it is only a matter of time until
2140     it can be done on wxGTK (Linux and other unixes) as well.
2141
2142     Unicode works best on platforms in the NT branch of the Windows
2143     family tree (NT, win2k, XP) but it is now also possible to use the
2144     same unicode binaries on win95/98/ME platforms as well!  This is
2145     done by using a special library and DLL with the application
2146     called MSLU, (Microsoft Layer for Unicode).  It simply gets out of
2147     the way if the app is run on an NT box, otherwise if run on a
2148     win9x box it loads a special DLL that provides the unicode
2149     versions of the windows API.  So far I have not been able to get
2150     this to work perfectly on win9x.  Most things work fine but
2151     wxTaskBarIcon for example will cause a crash if used with the
2152     unicode build on win95.
2153
2154     So how do you use it?  It's very simple.  When unicode is enabled,
2155     then all functions and methods in wxPython that return a wxString
2156     from the C++ function will return a Python unicode object, and
2157     parameters to C++ functions/methods that expect a wxString can
2158     accept either a Python string or unicode object.  If a string
2159     object is passed then it will be decoded into unicode using the
2160     converter pointed to by wxConvCurrent, which will use the default
2161     system encoding.  If you need to use a string in some other
2162     encoding then you should convert it to unicode using the Python
2163     codecs first and then pass the unicode string to the wxPython
2164     method.
2165
2166 Added wxListCtrlAutoWidthMixin from Erik Westra.
2167
2168 Added wxIconBundle and wxTopLevelWindow.SetIcons.
2169
2170 Added wxLocale and wxEncodingConverter.
2171
2172 A little black magic...  When the C++ object (for a window or
2173 whatever) is deleted there is no way to force the Python shadow object
2174 to also be destroyed and clean up all references to it.  This leads to
2175 crashes if the shadow object tries to call a method with the old C++
2176 pointer.  The black magic I've done is to replace the __class__ in the
2177 Python instance object with a class that raises an exception whenever
2178 a method call (or other attribute access) is attempted.  This works
2179 for any class that is OOR aware.
2180
2181 Added OOR support for wxGridCellRenderer, wxGridCellEditor,
2182 wxGridCellAttr, wxGridCellAttrProvider, wxGridTableBase and their
2183 derived classes.
2184
2185 Added wxImage.GetDataBuffer which returns an in-place edit buffer of
2186 the image data.  (Patch #546009)
2187
2188 Added a sample that shows how to embed wxPython in a wxWindows C++
2189 application.
2190
2191 Added wxPyWindow, wxPyPanel and wxPyControl which are just like their
2192 wx counterparts except they allow some of the more common C++ virtual
2193 methods to be overridden in Python derived classes.  The methods
2194 supported are:
2195
2196     DoMoveWindow
2197     DoSetSize
2198     DoSetClientSize
2199     DoSetVirtualSize
2200     DoGetSize
2201     DoGetClientSize
2202     DoGetPosition
2203     DoGetVirtualSize
2204     DoGetBestSize
2205     InitDialog
2206     TransferDataFromWindow
2207     TransferDataToWindow
2208     Validate
2209     AcceptsFocus
2210     AcceptsFocusFromKeyboard
2211     GetMaxSize
2212     AddChild
2213     RemoveChild
2214
2215     If there are other methods that you think should be supported
2216     please let me know.
2217
2218 Changed wxGenButton to derive from wxPyControl and overload
2219 DoGetBestSize and AcceptsFocus.
2220
2221 Added wxArtProvider.
2222
2223 Added wxCallAfter which is a helper function that registers a function
2224 (or any callable Python object) to be called once the next time there
2225 are no pending events.  This is useful for when you need to do
2226 something but it can't be done during the current event handler.  The
2227 implementation is very simple, see wxPython/wx.py.
2228
2229 Fixed a boatload of reference leaks.
2230
2231 Added a demo of using a sizer in a wxScrolledWindow, in effect
2232 creating a ScrolledPanel.
2233
2234 Added a sample to the demo that shows how to use radio menu items, and
2235 other menu stuff.
2236
2237 Added wxIEHtmlWin.  This is essentially the same as using IE with the
2238 ActiveXWrapper already in the library, but it is implemented all in
2239 C++ and therefore does not need any of the modules from win32all and
2240 so it is less fragile in the face of changes.
2241
2242 Fixed the ActiveXWrapper problem.  Looks like when the win32com
2243 modules make a "callback" that they (incorrectly, IMHO) allocate a
2244 transient thread state structure.  Since wxPython is now saving
2245 tstates for it's own callbacks it ended up using garbage after
2246 win32com got rid of the temporary tstate...
2247
2248 Added a generic static text control to wxPython.lib.stattext.  This is
2249 so things like Boa and PythonCard can have a static text that can
2250 respond to mouse events and etc.
2251
2252 Changed the wxDateTime.Parse* methods to return an int that will be -1
2253 on failure, and the index where parsing stopped otherwise.
2254
2255 Moved tools to be a Python package in wxPython.tools, added scripts to
2256 import and launch each tool.  This will let you import and use the
2257 tools in your own scripts or apps as needed.  On Linux and OS X the
2258 tool scripts are installed to {prefix}/bin so you should be able to
2259 easily launch them from the command line.  For example, PyCrust can be
2260 started with just the "pycrust" command.
2261
2262 Added a sample to the demo that catches various key events and
2263 displays the details of the event.
2264
2265 Added wxWizard, wxWizardPage, wxWizardPageSimple and wxPyWizardPage.
2266
2267 Added wxXmlResourceHandler which allows you to create custom handlers
2268 for nonstandard class types in XRC resources.  See the demo for an
2269 example.
2270
2271 Added wxPython.lib.mixins.rubberband module from Robb Shecter.
2272
2273 Added wxTimeCtrl from Will Sadkin.
2274
2275
2276
2277
2278 2.3.2.1
2279 -------
2280 * 20-Dec-2001
2281
2282 Changed (again) how the Python global interpreter lock is handled as
2283 well as the Python thread state.  This time it works on SMP machines
2284 without barfing and is also still compatible with Python debuggers.
2285
2286 Added some patches from library contributors.
2287
2288
2289
2290 2.3.2
2291 -----
2292 * 11-Dec-2001
2293
2294 Added EVT_HELP, EVT_HELP_RANGE, EVT_DETAILED_HELP,
2295 EVT_DETAILED_HELP_RANGE, EVT_CONTEXT_MENU, wxHelpEvent,
2296 wxContextMenuEvent, wxContextHelp, wxContextHelpButton, wxTipWindow,
2297 and a demo to show them in action.
2298
2299 Deprecated PyShell and PyShellWindow, added a snapshot of PyCrust (see
2300 http://sourceforge.net/projects/pycrust/. )
2301
2302 Added the new virtual list capabilities to wxListCtrl.
2303
2304 Added a wxSTC style editor from Riaan Booysen to the sample apps.
2305
2306 Added XRCed to the wxPython Tools directory, contributed by Roman
2307 Rolinsky.
2308
2309 Added a new "constructor" to most of the window classes that calls the
2310 default C++ constructor, (the one with no parameters) and also added the
2311 corresponding  Create(...) method.  This allows you to do a 2-step
2312 creation of windows which is sometimes required for doing things such
2313 as setting extended style flags before the window is created, or for
2314 passing the object to the XRC resource system to be created from the
2315 resource.  The name of the new "constructor" is the original name of
2316 the class with a "Pre" in it.  For example, wxPreWindow, wxPreFrame,
2317 etc.
2318
2319 Updated to version 1.40 of Scintilla and updated wxStyledTextCtrl
2320 accordingly.  While doing this update I dropped the wxLB_SORT style
2321 from the wxListBox created for the AutoComplete functionality.  This
2322 means that you will have to sort the keyword lists yourself, but you
2323 are free to do case sensitive or case insensitive sorts and set the
2324 wxSTC flag accordingly.
2325
2326 Updated wxColumnSorterMixin to also be able to place sort icons on the
2327 column headers, and updated the wxListCtrl demo to show it off by
2328 using wxColumnSorterMixin.
2329
2330 Added wxGenBitmapTextButton, TablePrint, etc. contribs from Lorne White.
2331
2332 Added wxNativeFontInfo and wxFontMapper.
2333
2334 Added pySketch to the samples.
2335
2336 Significantly changed how the Python interpreter lock and thread state
2337 are managed, which should fix the problem of running on a
2338 multi-processor machine.
2339
2340 Added wxPyLog so log targets can be created in Python to handle log
2341 messages however is wished.  See demo/Main.py for an example.
2342
2343 Added wxFindReplaceDialog.
2344
2345 The second phase of OOR is implemented for wxEvtHandler, wxSizer,
2346 wxShape and derived classes.  This means that functions and methods
2347 that return an object derived from wxEvtHandler that was originally
2348 created in Python, will return the original Python object (if it still
2349 exists) instead of letting SWIG wrap a new shadow object around the
2350 original C++ pointer.
2351
2352 Added some optimization methods to wxDC: GetBoundingBox, DrawLineList,
2353 DrawPointList.
2354
2355 Added a set of sophisticated Error Dialogs from Chris Fama.
2356
2357 Added wxRightTextCtrl from Josu Oyanguren to wxPython.lib for aligning
2358 text in a wxTextCtrl to the right side.
2359
2360 Added wxURLDataObject and an example showing drag and drop of URLs to
2361 and from web browsers.  It's still not 100% bullet-proof for all types
2362 of browsers, but it works for the majority of cases with the popular
2363 browsers on Windows.  On wxGTK it seems that only Netscape 4.x works,
2364 if anybody has any suggestions about this please bring it up on the
2365 wx-dev list.
2366
2367 Added wxStopWatch.
2368
2369 Added wxMimeTypesManager and wxFileType.
2370
2371 Passing None for the handler parameter to one of the EVT_** functions
2372 will now Disconnect the event.
2373
2374 Added wxPopupWindow and wxPopupTransientWindow.
2375
2376 Added wxFileHistory.
2377
2378 Added wxDynamicSashWindow, which allows you to endlessly split windows
2379 by dragging a little tab next to the scrollbars.  Added a demo to show
2380 this and also the ability of multiple wxStyledTextCtrls to share the
2381 same document.
2382
2383 Added wxEditableListBox gizmo.
2384
2385 Updated wxEditor with lots of enhancements from Steve Howell and Adam
2386 Feuer.
2387
2388 Added the "SplitTree gizmos" which are a collection of classes that
2389 were designed to operate together and provide a tree control with
2390 additional columns for each item.  The classes are
2391 wxRemotelyScrolledTreeCtrl, wxTreeCompanionWindow,
2392 wxThinSplitterWindow, and wxSplitterScrolledWindow, some of which may
2393 also be useful by themselves.
2394
2395 Added wxDllWidget from Vaclav Slavik which allows wx widgets derived
2396 from wxWindow to be loaded from a C++ .dll (or .so) and be used in a
2397 wxPython program, without the widget having to be SWIGged first.  The
2398 visible API of the widget is limited to wxWindow methods plus a
2399 SendCommand method, but it is still quite powerful.  See
2400 wxPython/contrib/dllwidget and wxPython/demo/dllwidget for more
2401 details.
2402
2403
2404
2405
2406 2.3.1
2407 -----
2408 * 10-Jul-2001
2409
2410 Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user
2411 code can get access to the edit control when it is created, (to push
2412 on a custom event handler for example.)
2413
2414 Added wxTextAttr class and SetStyle, SetDefaultStyle and
2415 GetDefaultStyle methods to wxTextCtrl.
2416
2417 Added ability to use xml resource files.  Still need to add ability to
2418 subclass wxXmlResourceHandler, etc...
2419
2420 Added wxGridAutoEditMixin to the mixins library package.
2421
2422 Made ColourSelect be derived from wxButton.
2423
2424 Fixed img2py to work correctly with Python 2.1.
2425
2426 Added enhanced wxVTKRenderWindow by Prabhu Ramachandran
2427
2428
2429
2430 2.3.0
2431 -----
2432 * 22-May-2001
2433
2434 Removed initial startup dependency on the OpenGL DLLs so only the
2435 glcanvasc.pyd depends on them, (on wxMSW.)
2436
2437 Changed wxFont, wxPen, wxBrush to not implicitly use the
2438 wxThe[Font|Pen|Brush]List objects behind the scenes, but to use normal
2439 ctor and dtors.
2440
2441 Exposed the wxThe[Font|Pen|Brush]List to wxPython.
2442
2443 Also added wxTheColourDatabase and added a library module (in the
2444 wxPython.lib.colourdb module) to load LOTS more colour names into the
2445 colour database.
2446
2447 Added wxWakeUpMainThread, wxMutexGuiEnter, wxMutexGuiLeave,
2448 wxMutexGuiLocker and wxThread_IsMain to assist with dealing with GUI
2449 access from non-GUI threads.
2450
2451 wxPyOnDemandOutputWindow is now (more) thread safe if non-GUI threads
2452 use print, sys.stdout.write, etc.
2453
2454 Added CreateTextSizer and CreateButtonSizer to wxDialog
2455
2456 Added wxPython/lib/infoframe.py from Chris Fama.  It contains a class
2457 that can be used in place of wxPyOnDemandOutputWindow.
2458
2459 Added colourselect.py, imagebrowser.py and an updated calendar.py to
2460 wxPython/lib from Lorne White.
2461
2462 Added patch to wxPoint_LIST_helper from Tim Hochberg that should make
2463 it gobs faster in certain situations.
2464
2465 Added tools that will take an image file in a wx supported format and
2466 convert it to data embedded in a Python source file.  The image is
2467 converted to XPM format which is essentially a list of strings
2468 containing info about each pixel.  The image's transparency mask is
2469 included, if there is one, or a mask can be added if a mask colour is
2470 specified on the command line.  It is then pickled and optionally
2471 compressed and written to a Python source file along with functions to
2472 convert it to either a wxBitmap or a wxImage.  See
2473 wxPython/demo/images.py for examples, and wxPython/Tools/img2py.py for
2474 the implementation.
2475
2476 Fixed wxStyledTextCtrl to be much faster on wxGTK.  There was some
2477 experimental code that got left in place that ended up causing way too
2478 many refreshes.
2479
2480 A couple more hacks in my_distutils.py so wxPython can be built with
2481 the distutils that comes with Python 2.1.
2482
2483 Added a ton of missing methods for wxPrintData.
2484
2485 Switched to InnoSetup for MSW distributions.
2486
2487 Added wxToggleButton.
2488
2489 Fixed bug that prevented wxTreeCtrl.OnCompareItems from being called.
2490
2491 Added some methods to wxGrid:
2492       GetCellHighlightPenWidth
2493       GetCellHighlightROPenWidth
2494       SetCellHighlightPenWidth
2495       SetCellHighlightROPenWidth
2496       GetGridWindow
2497       GetGridRowLabelWindow
2498       GetGridColLabelWindow
2499       GetGridCornerLabelWindow
2500
2501 Added wxGetClientDisplayRect which on wxMSW returns a wxRect
2502 representing the area on screen not occupied by the taskbar and such.
2503 On other platforms it is equivallent to wxGetDisplaySize.
2504
2505 OOR:
2506    Implemented the first phase of OOR (Original Object Return).  See
2507    the text in the demo for more details of what this means, but in a
2508    nutshell methods such as wxWindow.GetParent or FindWindowById will
2509    now return a shadow object of the proper type if it can.  By
2510    "proper type" I mean that if the wxWindow pointer returned from
2511    FindWindowById really points to a wxButton then the Python object
2512    constructed will be of a wxButtonPtr class instead of wxWindowPtr
2513    as before.  This should reduce or eliminiate the need for
2514    wxPyTypeCast.  (Woo Hoo!)  The objects returned are still not the
2515    original Python object, but that is the next step.  (Although it
2516    will probably only work on Python 2.1 and beyond because it will
2517    use weak references.)
2518
2519    This first phase of the OOR plan is fairly significant and has
2520    required a lot of changes all over wxPython, most of which should
2521    be transparent to you, however I'm not 100% sure that it didn't
2522    introduce any new bugs that are hiding somewhere and didn't get
2523    stomped on during my testing.  So please be sure to test everything
2524    thoroughly when you install this version and be sure to report any
2525    object-type related oddities to me.
2526
2527
2528 There is now a wxObject class that most other classes derive from like
2529 in C++, but the methods provided don't really match but are wxPython
2530 specific.  It could have been added long ago but OOR required it so it
2531 finally got done.
2532
2533 Finally added wxPyLineShape.GetLineControlPoints, which has been on my
2534 list for a while.  The above OOR modification made this easier.
2535
2536 Fixed the __cmp__ methods for wxPoint and others.
2537
2538 Added wxWave.
2539
2540 Added the wxPython.lib.mixins package to the library, it is where
2541 useful mix-in classes can be placed.  Currently there is one to help
2542 make the columns in a wxListCtrl sortable, and the MagicIMageList from
2543 Mike Fletcher.  If you have any custom code that can be factored out
2544 of existing classes into a mix-in that would be useful to others
2545 please send it to me for inclusion in this package.
2546
2547 Added a few little sample applications to help newbies to get started
2548 by having smaller functional apps to play with.  They can be found in
2549 wxPython/samples.
2550
2551
2552
2553
2554 2.2.7
2555 -----
2556 * 19-Jun-2001
2557
2558 No changes happened in the Python wrappers for this release, only
2559 changes and fixes in the wxWindows library.
2560
2561
2562
2563 2.2.5
2564 -----
2565 * 30-Jan-2001
2566
2567 New typemaps for wxString when compiling for Python 2.0 and beyond
2568 that allow Unicode objects to be passed as well as String objects.  If
2569 a Unicode object is passed PyString_AsStringAndSize is used to convert
2570 it to a wxString using the default encoding.
2571
2572 Fixed the generic buttons so tool tips work for them.
2573
2574 Fixed a bug in the demo's tree control.
2575
2576 Added a listbox to the listbox demo that shows how to find items with
2577 a matching prefix as keys are typed.
2578
2579 Added code to the wxListCtrl demo to show how to get text from a
2580 column in report mode.
2581
2582 Added code to the toolbar demo to clear the long help from the status
2583 bar after 2 seconds.
2584
2585 Added wxJoystick.
2586
2587 Fixed wxTimer so it can be used as described in the docs, either with
2588 a Notify method in a subclass, or sending an event to a wxEvtHandler
2589 object, (usually a window.)
2590
2591 Added wxNotifyEvent.Allow()
2592
2593 Fixed GOBS of reference leaks.
2594
2595 Massive code changes and cleanup to allow wxPython to be split into
2596 multiple extension modules again.  A Python CObject is used to allow
2597 the "export" of SWIG functions and other common helper functions from
2598 the wxc module to other modules, even if they are in separate shared
2599 libraries.  Should also be usable from 3rd party code, just include
2600 wxPython/src/export.h
2601
2602 Changed the default setup so the following are built as separate
2603 extension modules:  calendar, glcanvas, grid, html, ogl, stc, and
2604 utils.  Will probably add more later.
2605
2606 Changed the wxPrinterDC to use the new constructor taking a
2607 wxPrintData object.  The old ctor is still there using the
2608 wxPrinterDC2 name.
2609
2610 Added wxPython.lib.anchors.py from Riaan Booysen.  It contains a class
2611 that implements Delphi's Anchors with wxLayoutConstraints.
2612
2613 Added wxPython.lib.fancytext from Timothy Hochberg.
2614
2615 Changed the GenericButtons to send their event in idle time, so the
2616 mouse won't be captured when the event handler is called.
2617
2618 Added wxPython.lib.rpcMixin from Greg Landrum, although it's not
2619 integrated with the demo yet.  It allows a wxPython GUI to be an
2620 XML-RPC server.
2621
2622
2623
2624 New in 2.2.2
2625 ------------
2626 * 26-Oct-2000
2627
2628 Significantly changed how the wxStyledtextCtrl code that wraps
2629 Scintilla is implemented.  Most of it is now automatically generated
2630 from an interface definition file provided by Scintilla.  This means
2631 that it will be much easier to stay in sync with new Scintilla
2632 releases, but also means that some of the method and identifier names
2633 have changed.  See wxPython/demo/data/stc.h for a copy of the C++
2634 interface from which the Python interface is generated.  There is now
2635 some inline documentation in that file that should really help explain
2636 how things work.
2637
2638 I am now using the Python Distutils to build wxPython and to make some
2639 of the distribution files.  (See http://www.python.org/sigs/distutils-sig/)
2640 This means no more messing with my kludgy build.py/Makefile hack,
2641 builds will be more consistent with other Python extensions that also
2642 use Distutils, and will hopefully make wxPython easier to build for
2643 platforms where there have been troubles before.  If you are building
2644 wxPython for Python 1.5.2 or for 1.6, then you will need to get and
2645 install version 1.0 of Distutils from the website above.  If you are
2646 using Python 2.0 then you already have it.
2647
2648 Added wxInputStream and the wxFileSystem family of classes,
2649 contributed by Joerg Baumann.
2650
2651 Added wxProcess and support for it to wxExecute.  wxProcess lets you
2652 get notified when an asyncronous child process terminates, and also to
2653 get input/output streams for the child process's stdout, stderr and
2654 stdin.
2655
2656 Removed the old python sizers.
2657
2658 Added __add__, __sub__ and __cmp__ (equality check only) for wxPoint
2659 and wxRealPoint.
2660
2661 Changed the build to make one big extension module instead of one for
2662 the core and each contrib.  This allowed me to do away with the
2663 libwxPyHelpers.so on unix systems.
2664
2665 Lots of little fixes here and there.
2666
2667 Some hacks on wxGTK to try and make the AutoComplete listbox in the
2668 wxStyledTextCtrl to behave better.  It's still not as nice as on
2669 wxMSW, but at least it's a bit more usable now.
2670
2671
2672
2673
2674 New in 2.2.1
2675 ------------
2676 * 22-Aug-2000
2677
2678 Various tweaks, fixes, missing methods, etc.
2679
2680 Added example use of wxTaskBarIcon to the demo.
2681
2682
2683
2684 New in 2.2.0
2685 ------------
2686 * 17-Jul-2000
2687
2688 Added wxLog and friends.
2689
2690 Added wxFrame.ShowFullScreen for MSW.
2691
2692 Added PyShellWindow to the wxPython.lib package.
2693
2694
2695
2696 New in 2.1.16
2697 -------------
2698 * 12-Jun-2000
2699
2700 Added an attribute named labelDelta to the generic buttons that
2701 specifies how far to offset the label when the button is in the
2702 depressed state.
2703
2704 Added wxTipProvider and friends.  See the demo for an example.
2705
2706 wxGrid can now change the cell highlight colour.
2707
2708 Added wxDragImage.
2709
2710 Fixed printing on wxGTK.
2711
2712 Added wxDateTime, wxTimeSpan, and wxDateSpan to wxPython.utils.
2713
2714 Added wxCalendarCtrl.
2715
2716 WARNING: A while back I asked what should be done about the Magic
2717 Method Names.  (Methods that are automatically turned into event
2718 handlers by virtue of their name.)  The consensus was that it is more
2719 confusing to have them than to try and expand them to have greater
2720 coverage.  I am finally getting around to removing the code that
2721 generates the event binding.  This means that if you are using any of
2722 the following method names without a EVT_* call that you need to
2723 modify your code to add the EVT_* to hook the event to the method.
2724
2725     OnChar
2726     OnSize
2727     OnEraseBackground
2728     OnSysColourChanged
2729     OnInitDialog
2730     OnPaint
2731     OnIdle
2732     OnActivate
2733     OnMenuHighlight
2734     OnCloseWindow
2735     OnScroll
2736
2737 Added wxSpinCtrl.
2738
2739
2740
2741
2742 New in 2.1.15
2743 -------------
2744 * 25-Apr-2000
2745
2746 Fixed wxTreeCtrl.HitTest to return both the tree item as well as the
2747 flags that clairify where the click was in relation to the item.
2748
2749 Fixed thread state problem in wxTreeCtrl.GetBoundingBox and
2750 GetSelections.
2751
2752 Fixed some problems in OGL.  Also wxShape.SetClientData and
2753 .GetClientData can now deal with Python objects.
2754
2755 Added wxListCtrl.SortItems and changed the demo to show how to use it.
2756
2757 Plugged a memory leak.
2758
2759 Wrapped the new wxGrid and friends.  The old wxGrid class is no longer
2760 available.  There are some incompatibilities, and unfortunately the
2761 new classes are not documented yet, (however the methods are more
2762 consistent with each other now so you may be able to guess pretty
2763 good...)
2764
2765 Updated filebrowsebutton.py and calendar.py with changes from their
2766 authors.  There is now a FileBrowseButtonWithHistory class (what a
2767 mouthful!) and wxCalendar has printing support.
2768
2769 Added ActiveXWrapper to the library, and some good demos of it too.
2770 It works great for embedding a COM (a.k.a OCX, a.k.a ActiveX) control
2771 in a window and calling its methods.  It actually creates a new class
2772 on the fly that derives from wxWindow, the COM CoClass and others
2773 needed to make it all work.  The resulting class can be instantiated
2774 just like wxWindow, used in sizers, etc.  It also responds to all COM
2775 method calls, properties, etc., and if the class or a mix-in has
2776 matching method names, then the COM events will be propogated back to
2777 them.
2778
2779 Created a typemap that allows a string to be used for parameters
2780 expecting a wxColour type.  The string is either a colour name as
2781 defined in the wxColourDatabase, or a colour spec of the form
2782 "#RRGGBB".  See the wxStyledTextCtrl demo for an example.
2783
2784 I almost forgot to mention the wxStyledTextCtrl!  Yes, the
2785 wxStyledTextCtrl is finally in wxPython!!  (And the crowd goes
2786 wild...)   There's no documentaTion yet (the crowd boos and hisses...)
2787 but I've included a very readable source file in the
2788 wxPython/demo/data directory, a couple fairly good examples, and you
2789 can also refer to the Scintilla documentaion at
2790 http://www.scintilla.org/ScintillaDoc.html to help fill in the gaps
2791 until the docs are done.  (The croud murmers contentedly as the tool
2792 provider smiles convincingly and removes his flame-proof suit.)
2793
2794
2795
2796
2797 What's new in 2.1.13
2798 --------------------
2799 * 3-Feb-2000
2800
2801 Skipped a version number to match what has been released for wxGTK.
2802
2803 Updated wxMVCTree and added a demo for it, also fixed layout on GTK
2804 and some flicker problems.
2805
2806 Added a wrapper class for the Visualization ToolKit (or VTK) in the
2807 wxPython.lib.vtk module.  (http://www.kitware.com/)
2808
2809 Fixed wxTreeCtrl.SetItemImage and GetItemImage to recognise the new
2810 "which" parameter.
2811
2812 Added wxPython.lib.spashscreen from Mike Fletcher.
2813
2814 Added wxPython.lib.filebrowsebutton also from Mike Fletcher.
2815
2816 Renamed wxTreeCtrl.GetParent to GetItemParent to avoid a name clash
2817 with wxWindow.GetParent.
2818
2819 Added wxIntersectRect to compute the intersection of two wxRect's.
2820 It is used like this:
2821
2822    intersect = wxIntersectRect(rect1, rect2)
2823
2824 If r1 and r2 don't intersect then None is returned, otherwise the
2825 rectangle representing the intersection is returned.
2826
2827 Some bug fixes for Clipboard and Drag-n-Drop.
2828
2829 Rotated text!!!  WooHoo!  (See wxDC.DrawRotatedText())
2830
2831 Added a set of Generic Buttons to the library.  These are simple
2832 window classes that look and act like native buttons, but you can have
2833 a bit more control over them.  The bezel width can be set in addition
2834 to colours, fonts, etc.  There is a ToggleButton as well as Bitmap
2835 versions too.  They should also serve as a good example of how to
2836 create your own classes derived from wxControl.
2837
2838 The C++ wxToolBar classes have been redone, and so have the wxPython
2839 wrappers.  There have been slight modifications to some of the methods
2840 but shouldn't impact anybody too much.  I took the opportunity to add
2841 support for setting user data on each toolbar tool.  The new AddTool
2842 methods look like this:
2843
2844         def AddTool(ID,
2845                     bitmap,
2846                     pushedBitmap = wxNullBitmap,
2847                     toggle = FALSE,
2848                     clientData = NULL,
2849                     shortHelpString = "",
2850                     longHelpString = "")
2851
2852         def AddSimpleTool(ID,
2853                           bitmap,
2854                           shortHelpString = "",
2855                           longHelpString = "",
2856                           toggle=FALSE)
2857
2858
2859 There are also corresponding InsertTool and InsertSimpleTool methods
2860 that additionally take an integer position as the first parameter.
2861
2862 Added a wrapper for the new PCX and TIFF ImageHandlers.
2863
2864 wxRect now simulates attributes named left, right, top and bottom.
2865
2866 Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
2867 is better and compatible with the wxGLCanvas.  You can get it at
2868 http://starship.python.net:9673/crew/da/Code/PyOpenGL.
2869
2870 Added some missing EVT functions.
2871
2872 Added Dirk Holtwic's editor classes to the wxPython.lib.editor
2873 package.
2874
2875 Changed all the "LIST" parameter names to "choices" to match the docs.
2876
2877 More fixes for the wxFloatBar, and it now works on wxGTK even better
2878 than wxMSW!  (The feat is accomplished by using the wxTB_DOCKABLE
2879 style flag instead of trying to float it ourselves.)
2880
2881
2882
2883
2884 What's new in 2.1.11
2885 --------------------
2886 * 13-Nov-1999
2887
2888 Skipped a few version numbers so wxMSW, wxGTK and wxPython are all
2889 syncronized.
2890
2891 wxImage.SetData now makes a copy of the image data before giving it to
2892 wxImage.  I mistakenly thought that wxImage would copy the data
2893 itself.
2894
2895 Fixed wxMSW's notebook so the pages get their size set as they are
2896 being added.  This should remove the need for our
2897 wxNotebook.ResizeChildren hack.
2898
2899 wxPanels now support AutoLayout, and wxNotebooks and wxSplitterWindows
2900 no longer tell their children to Layout() themselves.  This will
2901 probably only effect you if you have a wxWindow with AutoLayout inside
2902 a notebook or splitter.  If so, either change it to a wxPanel or add
2903 an EVT_SIZE handler that calls Layout().
2904
2905 Fixed deadlock problem that happened when using threads.
2906
2907 Added new HTML printing classes.
2908
2909 Added wxWindow.GetHandle
2910
2911 Apparently wxMouseEvent.Position has been deprecated in wxWindows as
2912 it is no longer available by default.  You can use GetPositionTuple
2913 (returning a tuple with x,y) instead, or GetPosition (returning a
2914 wxPoint.)
2915
2916 Added wxPostEvent function that allows events to be posted and then
2917 processed later.  This is a thread-safe way to interact with the GUI
2918 thread from other threads.
2919
2920 Added Clipboard and Drag-and-Drop classes.
2921
2922 Added wxFontEnumerator.
2923
2924 Many updates to wxMenu, wxMenuBar.
2925
2926 wxPyEvent and wxPyCommandEvent derived classes now give you the actual
2927 Python object in the event handler instead of a new shadow.
2928
2929 Added a Calendar widget from Lorne White to the library.
2930
2931 Made some fixes to the wxFloatbar.  It still has some troubles on
2932 wxGTK...
2933
2934 Added an MVC tree control from Bryn Keller to the library.
2935
2936
2937
2938
2939 What's new in 2.1.5
2940 -------------------
2941 * 12-Oct-1999
2942
2943 This is a quick bug-fix release to take care of a few nasties that
2944 crept in at the last minute before 2.1.4 was called done.  No new
2945 major features.
2946
2947
2948
2949 What's new in 2.1.4
2950 -------------------
2951 * 7-Oct-1999
2952
2953 This release is NOT syncronized with a snapshot release of wxGTK or
2954 wxMSW.  For MSW this isn't much of a problem since you can get the
2955 binaries from the web site.  For other platforms you'll have to build
2956 wxGTK from CVS.  (See http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm)
2957 To get the same set of sources from CVS that I used, checkout using
2958 the wxPy-2-1-4 tag.
2959
2960 Now back to what's new...
2961
2962 Much more support for event-less callbacks and add-on modules.
2963
2964 Created add-on module with wxOGL classes.
2965
2966 Added wxWindow.GetChildren().  Be careful of this.  It returns a *copy*
2967 of the list of the window's children.  While you are using the list if
2968 anything changes in the real list (a child is deleted, etc.) then the
2969 list you are holding will suddenly have window references to garbage
2970 memory and your app will likely crash.  But if you are careful it works
2971 great!
2972
2973 Added a bunch of new and missing methods to wxTreeCrtl.  The
2974 SortChildren method is now supported, but currently only for the
2975 default sort order.
2976
2977 Added typemaps for wxSize, wxPoint, wxRealPoint, and wxRect that allow
2978 either the actual objects or Python sequence values to be used.  For
2979 example, the following are equivallent::
2980
2981     win = wxWindow(parent, size = wxSize(100, 100))
2982     win = wxWindow(parent, size = (100, 100))
2983
2984 Super-charged the wxHtml module.  You can now create your own tag
2985 handlers and also have access to the parser and cell classes.  There
2986 is a tag handler in the library at wxPython.lib.wxpTag that
2987 understands the WXP tag and is able to place wxPython windows on HTML
2988 pages.  See the demo for an example.
2989
2990 A bunch of the methods of wxMenuBar were previously ifdef'd out for
2991 wxGTK.  Added them back in since the methods exist now.
2992
2993 Wrapped the wxHtmlHelpController and related classes.
2994
2995 Wrapped the C++ versions of wxSizer and friends.  The Python-only
2996 versions are still in the library, but deprecated.  (You will get a
2997 warning message if you try to use them, but the warning can be
2998 disabled.) The usage of the C++ versions is slightly different, and
2999 the functionality of wxBorderSizer is now part of wxBoxSizer.  I have
3000 added a few methods to wxSizer to try and make the transition as
3001 smooth as possible, I combined all Add methods into a single method
3002 that handles all cases, added an AddMany method, etc.  One step I did
3003 not take was to make the default value of flag in the Add method be
3004 wxGROW.  This would have made it more backward compatible, but less
3005 portable to and from wxWin C++ code.  Please see the docs and demo for
3006 further details.
3007
3008 Added wxPyEvent and wxPyCommandEvent classes, derived from wxEvent and
3009 wxCommandEvent.  Each of them has SetPyData and GetPyData methods that
3010 accept or return a single Python object.  You can use these classes
3011 directly or derive from them to create your own types of event objects
3012 that can pass through the wxWindows event system without loosing their
3013 Python parts (as long as they are stored with SetPyData.)  Stay tuned
3014 for more info and examples in future releases.
3015
3016 Added wxPython.lib.grids as an example of how to derive a new sizer
3017 from the C++ sizers.  In this module you will find wxGridSizer and
3018 wxFlexGridSizer.  wxGridSizer arrainges its items in a grid in which
3019 all the widths and heights are the same.  wxFlexgridSizer allows
3020 different widths and heights, and you can also specify rows and/or
3021 columns that are growable.  See the demo for a couple examples for how
3022 to use them.
3023
3024 Added the wxValidator class, and created a class named wxPyValidator
3025 that should be used for the base class of any Python validators.  See
3026 the demo for an example.  Please note that you MUST implement a Clone
3027 method in your validator classes because of the way some things work
3028 in the underlying C++ library.  I did not add wxTextValidator because
3029 of some issues of how it transfers data to and from a wxString, which
3030 in wxPython is automatically translated to and from Python strings, so
3031 there would never be a concrete wxString that would hang around long
3032 enough for the validator to do its job.  On the other hand, it should
3033 be real easy to duplicate the functionality of wxTextValidator in a
3034 pure Python class derived from wxPyValidator.
3035
3036 I've finally added a feature that has been on my list for close to two
3037 years!  Ever wondered what that zero is for when you create your app
3038 object?  Well now you can leave it out or explicitly set it to a true
3039 value.  This value now controls what is to be done with sys.stdout and
3040 sys.stderr.  A false value leaves them alone, and a true value sets
3041 them to an instance of wxPyOnDemandOutputWindow.  (On windows the
3042 default is true, on unix platforms the default is false.)  This class
3043 creates a frame containing a wxTextCtrl as soon as anything is written
3044 to sys.stdout or sys.stderr.  If you close the window it will come
3045 back again the next time something is written.  (You can call
3046 app.RestoreStdio to turn this off.)  If you would rather that the stdio be
3047 redirected to a file, you can provide a second parameter to your app
3048 object's constructor that is a filename.  If you want to use your own
3049 class instead of wxPyOnDemandOutputWindow you can either implement
3050 RedirectStdio() in you app class or change the value of
3051 wxApp.outputWindowClass like this::
3052
3053     class MyApp(wxApp):
3054         outputWindowClass = MyClass
3055
3056         def OnInit(self):
3057             frame = MyFrame()
3058             self.SetTopWindow(frame)
3059             return true
3060
3061 Please see the implementation of wxPyOnDemandOutputWindow and wxApp in
3062 wx.py for more details.  A few words of caution:  if you are running
3063 your app in a debugger, changing sys.stdout and sys.stderr is likely
3064 to really screw things up.
3065
3066 Added wxCaret.  Unfortunately it's author has still not documented it
3067 in the wxWindows docs...
3068
3069 Some new 3rd party contributions in wxPython.lib.  PyShell, in
3070 shell.py is an interesting implementaion of an interactive Python
3071 shell in wxWindows.  floatbar.py has a class derived from wxToolBar
3072 that can sense mouse drags and then reparent itself into another
3073 frame. Moving the new frame close to where it came from puts the tool
3074 bar back into the original parent.  (Unfortunately there is currently
3075 a bug in wxGTK's wxFrame.SetToolBar so the FloatBar has some
3076 problems...)
3077
3078
3079
3080
3081 What's new in 2.1b3
3082 --------------------
3083 * 1-Sep-1999
3084
3085 This release is syncronized with release 2.1 snapshot 9 of wxWindows.
3086
3087 Switched to using SWIG from CVS (see http://swig.cs.uchicago.edu/cvs.html)
3088 for some of the new features and such.  Also they have encorporated my
3089 patches so there is really no reason to stick with the current (very
3090 old) release...  This version of SWIG gives the following new
3091 features:
3092
3093     1. Keyword arguments.  You no longer have to specify all the
3094        parameters with defaults to a method just to specify a
3095        non-default value on the end.  You can now do this instead:
3096
3097           win = wxWindow(parent, -1, style = mystyle)
3098
3099     2. There is now an an equivalence between Python's None and C++'s
3100        NULL.  This means that any methods that might return NULL will
3101        now return None and you can use none where wxWindows might be
3102        expecting NULL.  This makes things much more snake-ish.
3103
3104
3105 There is a new build system based on a new Python program instead of
3106 raw makefiles.  Now wxPython builds are virtually the same on MSW or
3107 Unix systems.  See the end of this file for new build instructions and
3108 see distrib/build.py for more details.
3109
3110 wxDC.Bilt now includes the useMask parameter, and has been split into
3111 two different versions.  wxDC.BlitXY is like what was there before and
3112 takes raw coordinants and sizes, and the new wxDC.Blit is for the new
3113 interface using wxPoints and a wxSize.
3114
3115
3116
3117
3118
3119 What's new in 2.1b2
3120 -------------------
3121 * 6-Aug-1999
3122
3123 Added the missing wxWindow.GetUpdateRegion() method.
3124
3125 Made a new change in SWIG (update your patches everybody) that
3126 provides a fix for global shadow objects that get an exception in
3127 their __del__ when their extension module has already been deleted.
3128 It was only a 1 line change in .../SWIG/Modules/pycpp.cxx at about
3129 line 496 if you want to do it by hand.
3130
3131 It is now possible to run through MainLoop more than once in any one
3132 process.  The cleanup that used to happen as MainLoop completed (and
3133 prevented it from running again) has been delayed until the wxc module
3134 is being unloaded by Python.
3135
3136 I fixed a bunch of stuff in the C++ version of wxGrid so it wouldn't
3137 make wxPython look bad.
3138
3139 wxWindow.PopupMenu() now takes a wxPoint instead of  x,y.  Added
3140 wxWindow.PopupMenuXY to be consistent with some other methods.
3141
3142 Added wxGrid.SetEditInPlace and wxGrid.GetEditInPlace.
3143
3144 You can now provide your own app.MainLoop method.  See
3145 wxPython/demo/demoMainLoop.py for an example and some explaination.
3146
3147 Got the in-place-edit for the wxTreeCtrl fixed and added some demo
3148 code to show how to use it.
3149
3150 Put the wxIcon constructor back in for GTK as it now has one that
3151 matches MSW's.
3152
3153 Added wxGrid.GetCells
3154
3155 Added wxSystemSettings static methods as functions with names like
3156 wxSystemSettings_GetSystemColour.
3157
3158 Removed wxPyMenu since using menu callbacks have been deprecated in
3159 wxWindows.  Use wxMenu and events instead.
3160
3161 Added alternate wxBitmap constructor (for MSW only) as
3162       wxBitmapFromData(data, type, width, height, depth = 1)
3163
3164 Added a helper function named wxPyTypeCast that can convert shadow
3165 objects of one type into shadow objects of another type.  (Like doing
3166 a down-cast.)  See the implementation in wx.py for some docs.
3167
3168 Fixed wxImage GetData and SetData to properly use String objects for
3169 data transfer.
3170
3171 Added access methods to wxGridEvent.
3172
3173 New Makefile/Setup files supporting multiple dynamic extension modules
3174 for unix systems.
3175
3176 Fixes for the wxGLCanvas demo to work around a strange bug in gtk.
3177
3178 SWIG support routines now compiled separately instead of being bundled
3179 in wx.cpp.
3180
3181
3182
3183
3184
3185 What's new in 2.1b1
3186 -------------------
3187 * 28-Jun-1999
3188
3189 Fixed wxComboBox.SetSelection so that it actually sets the selected
3190 item.  (Actually just removed it from wxPython and let it default to
3191 wxChoice.SetSelection which was already doing the right thing.)
3192
3193 Added the Printing Framework.
3194
3195 Switched back to using the wxWindows DLL for the pre-built Win32
3196 version.  The problem was needing to reinitialize static class info
3197 data after loading each extension module.
3198
3199 Lots of little tweaks and additions to reflect changes to various
3200 wxWindows classes.
3201
3202 Fixed a bug with attaching objects to tree items.  Actually was a
3203 symptom of a larger problem with not obtaining the interpreter lock
3204 when doing any Py_DECREFs.
3205
3206 wxSizer and friends.  Sizers are layout tools that manage a colection
3207 of windows and sizers.  Different types of sizers apply different
3208 types of layout algorithms.  You saw it here first!  These classes are
3209 not even in the wxWindows C++ library yet!
3210
3211
3212
3213 What's new in 2.0b9
3214 -------------------
3215 * 1-May-1999
3216
3217 Bug fix for ListCtrl in test4.py (Was a missing file...  DSM!)
3218
3219 Bug fix for occassional GPF on Win32 systems upon termination of a
3220 wxPython application.
3221
3222 Added wxListBox.GetSelections returning selections as a Tuple.
3223
3224 Added a wxTreeItemData that is able to hold any Python object and be
3225 associated with items in a wxTreeCtrl.  Added test pytree.py to show
3226 this feature off.
3227
3228 Added wxSafeYield function.
3229
3230 OpenGL Canvas can be optionally compiled in to wxPython.
3231
3232 Awesome new Demo Framework for showing off wxPython and for learning
3233 how it all works.
3234
3235 The pre-built Win32 version is no longer distributing the wxWindows
3236 DLL.  It is statically linked with the wxWindows library instead.
3237
3238 Added a couple missing items from the docs.
3239
3240 Added wxImage, wxImageHandler, wxPNGHandler, wxJPEGHandler,
3241 wxGIFHandler and wxBMPHandler.
3242
3243 Added new methods to wxTextCtrl.
3244
3245 Fixed some problems with how SWIG was wrapping some wxTreeCtrl
3246 methods.
3247
3248
3249
3250 What's new in 2.0b8
3251 -------------------
3252 * 28-Mar-1999
3253
3254 Support for using Python threads in wxPython apps.
3255
3256 Several missing methods from various classes.
3257
3258 Various bug fixes.
3259
3260
3261
3262 What's new in 2.0b7
3263 -------------------
3264 * 15-Mar-1999
3265
3266 Added DLG_PNT and DLG_SZE convienience methods to wxWindow class.
3267
3268 Added missing constructor and other methods for wxMenuItem.
3269
3270
3271
3272 What's new in 2.0b6
3273 -------------------
3274 * 4-Mar-1999
3275
3276 Just a quickie update to fix the self-installer to be compatible with
3277 Python 1.5.2b2's Registry settings.
3278
3279
3280 What's new in 2.0b5
3281 -------------------
3282 * 25-Feb-1999
3283
3284 Well obviously the numbering scheme has changed.  I did this to
3285 reflect the fact that this truly is the second major revision of
3286 wxPython, (well the third actually if you count the one I did for
3287 wxWindows 1.68 and then threw away...) and also that it is associated
3288 with the 2.0 version of wxWindows.
3289
3290 I have finally started documenting wxPython.  There are several pages
3291 in the wxWindows documentation tree specifically about wxPython, and I
3292 have added notes within the class references about where and how wxPython
3293 diverges from wxWindows.
3294
3295 Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
3296 window handle.  If you can get the window handle into the python code,
3297 it should just work...  More news on this later.
3298
3299 Added wxImageList, wxToolTip.
3300
3301 Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
3302 wxRegConfig class.
3303
3304 As usual, some bug fixes, tweaks, etc.
3305
3306
3307
3308 What's new in 0.5.3
3309 -------------------
3310 * 30-Jan-1999
3311
3312 Added wxSashWindow, wxSashEvent, wxLayoutAlgorithm, etc.
3313
3314 Various cleanup, tweaks, minor additions, etc. to maintain
3315 compatibility with the current wxWindows.
3316
3317
3318
3319 What's new in 0.5.0
3320 -------------------
3321 Changed the import semantics from ``"from wxPython import *"`` to
3322 ``"from wxPython.wx import *"``  This is for people who are worried about
3323 namespace pollution, they can use "from wxPython import wx" and then
3324 prefix all the wxPython identifiers with "wx."
3325
3326 Added wxTaskbarIcon for wxMSW.
3327
3328 Made the events work for wxGrid.
3329
3330 Added wxConfig.
3331
3332 Added wxMiniFrame for wxGTK.
3333
3334 Changed many of the args and return values that were pointers to gdi
3335 objects to references to reflect changes in the wxWindows API.
3336
3337 Other assorted fixes and additions.
3338
3339
3340
3341
3342 What's new in 0.4.2
3343 -------------------
3344 * 21-Oct-1998
3345
3346 wxPython on wxGTK works!!!  Both dynamic and static on Linux and
3347 static on Solaris have been tested.  Many thanks go to Harm van der
3348 Heijden for his astute detective work on tracking down a nasty DECREF
3349 bug.  Okay so I have to confess that it was just a DSM (Dumb Stupid
3350 Mistake) on my part but it was nasty none the less because the
3351 behavior was so different on different platforms.
3352
3353 The dynamicly loaded module on Solaris is still segfaulting, so it
3354 must have been a different issue all along...
3355
3356
3357
3358 What's New in 0.4
3359 -----------------
3360 * 2-Oct-1998
3361
3362 1. Worked on wxGTK compatibility.  It is partially working.  On a
3363 Solaris/Sparc box wxPython is working but only when it is statically
3364 linked with the Python interpreter.  When built as a dyamically loaded
3365 extension module, things start acting weirdly and it soon seg-faults.
3366 And on Linux both the statically linked and the dynamically linked
3367 version segfault shortly after starting up.
3368
3369 2. Added Toolbar, StatusBar and SplitterWindow classes.
3370
3371 3. Varioius bug fixes, enhancements, etc.
3372
3373
3374
3375
3376 wxPython 0.3
3377 ------------
3378 * 9-Aug-1998
3379
3380 The first "modern" version of wxPython.  See
3381 http://wiki.wxpython.org/index.cgi/WxPythonHistory
3382
3383