-----------------------------
-wxWindows 2.5/2.6 Change Log
-----------------------------
+------------------------
+wxWidgets 2.5 Change Log
+------------------------
INCOMPATIBLE CHANGES SINCE 2.4.x
================================
series.
! windows are no longer fully repainted when resized, use new style
- wxFULL_REPAINT_ON_RESIZE to force this (wxNO_FULL_REPAINT_ON_RESIZE stll
+ wxFULL_REPAINT_ON_RESIZE to force this (wxNO_FULL_REPAINT_ON_RESIZE still
exists but doesn't do anything any more, this behaviour is default now)
+! wxWindow::m_font and m_backgroundColour/m_foregroundColour are no longer
+ always set, use GetFont(), GetBack/ForegroundColour() to access
+ them, and they will be dynamically determined if necessary.
+
+
+! The Sizers have had some fundamental internal changes in the 2.5.2
+ and 2.5.3 releases intended to make them do more of the "Right
+ Thing" but also be as backwards compatible as possible. First a bit
+ about how things used to work:
+
+ * The size that a window had when Add()ed to the sizer was assumed
+ to be its minimal size, and that size would always be used by
+ default when calculating layout size and positions, and the
+ sizer itself would keep track of that minimal size.
+
+ * If the window item was Add()ed with the wxADJUST_MINSIZE flag
+ then when layout was calculated the item's GetBestSize would be
+ used to reset the minimal size that the sizer used.
+
+ The main thrust of the new Sizer changes was to make behaviour like
+ wxADJUST_MINSIZE be the default, and also to push the tracking of
+ the minimal size to the window itself (since it knows its own needs)
+ instead of having the sizer take care of it. Consequently these
+ changes were made:
+
+ * The wxFIXED_MINSIZE flag was added to allow for the old
+ behaviour. When this flag is used the size a window has when
+ Add()ed to the sizer will be treated as its minimal size and it
+ will not be readjusted on each layout.
+
+ * The min size stored in wxWindow and settable with SetSizeHints or
+ SetMinSize will by default be used by the sizer (if it was set)
+ as the minimal size of the sizer item. If the minsize was not
+ set (or was only partially set) then the window's best size is
+ fetched and it is used instead of (or blended with) the minsize.
+ wxWindow:GetBestFittingSize was added to facilitate getting the
+ size to be used by the sizers.
+
+ * The best size of a window is cached so it doesn't need to
+ recaculated on every layout. wxWindow::InvalidateBestSize was
+ added and should be called (usually just internally in control
+ methods) whenever something is done that would make the best
+ size change.
+
+ * All wxControls were changed to set the minsize to what is passed
+ to the constructor or Create method, and also to set the real
+ size of the control to the blending of the minsize and bestsize.
+ wxWindow::SetBestFittingSize was added to help with this,
+ although most controls don't need to call it directly because it
+ is called indirectly via the SetInitialSize called in the base
+ classes.
+
+ At this time, the only situation known not to work the same as
+ before is the following:
+
+ win = new SomeWidget(parent);
+ win->SetSize(SomeNonDefaultSize);
+ sizer->Add(win);
+
+ In this case the old code would have used the new size as the
+ minimum, but now the sizer will use the default size as the minimum
+ rather than the size set later. It is an easy fix though, just move
+ the specification of the size to the constructor (assuming that
+ SomeWidget will set its minsize there like the rest of the controls
+ do) or call SetMinSize instead of SetSize.
+
+ In order to fit well with this new scheme of things, all wxControls
+ or custom controls should do the following things. (Depending on
+ how they are used you may also want to do the same thing for
+ non-control custom windows.)
+
+ * Either override or inherit a meaningful DoGetBestSize method
+ that calculates whatever size is "best" for the control. Once
+ that size is calculated then there should normally be a call to
+ CacheBestSize to save it for later use, unless for some reason
+ you want the best size to be recalculated on every layout.
+
+ * Any method that changes the attributes of the control such that
+ the best size will change should call InvalidateBestSize so it
+ will be recalculated the next time it is needed.
+
+ * The control's constructor and/or Create method should ensure
+ that the minsize is set to the size passed in, and that the
+ control is sized to a blending of the min size and best size.
+ This can be done by calling SetBestFittingSize.
+
+
- no initialization/cleanup can be done in wxApp/~wxApp because they are
now called much earlier/later than before; please move any exiting code
from there to wxApp::OnInit()/OnExit()
- also, OnExit() is not called if OnInit() fails
+- finally the program exit code is OnRun() return value, not OnExit() one
- wxTheApp can't be assigned to any longer, use wxApp::SetInstance() instead
- wxFileType::GetIcon() returns wxIconLocation, not wxIcon
- wxColourDatabase is not a wxList any more, use AddColour to add new colours
- wxApp::SendIdleEvent() now takes 2 arguments
- wxTabView::GetLayers() changed return type from wxList& to wxTabLayerList&
(when WXWIN_COMPATIBILITY_2_4 == 0)
+- wxID_SEPARATOR (id used for the menu separators) value changed from -1 to -2
+- wxGetNumberFromUser() is now in separate wx/numdlg.h, not wx/textdlg.h
+- wxChoice and wxCombobox now handle their size in the same way as in all the
+ other ports under MSW, new code is actually correct but different from weird
+ stuff they were doing before so the behaviour of your programs might change
+- wxTaskBarIcon objects must now be destroyed before the application can exit.
+ Previously, the application terminated if there were no top level windows;
+ now it terminates if there are no top level windows or taskbar icons left.
+- wxZlibInputStream is not by default compatible with the output of the
+ 2.4.x version of wxZlibOutputStream. However, there is a compatibilty mode,
+ switched on by passing wxZLIB_24COMPATIBLE to the constructor.
+- when WXWIN_COMPATIBILITY_2_4 == 0 wxHashTable uses a new implementation
+ not using wxList keyed interface (the same used when wxUSE_STL == 1),
+ the only incompatibility being that Next() returns a wxHashTable::Node*
+ instead of a wxNode*.
+- non-const wxDC methods GetBackground(), GetBrush(), GetFont() and GetPen()
+ as well as wxWindow methods GetFont() and GetCursor() don't exist any more,
+ please fix your code -- it never worked correctly anyhow if you modified the
+ objects returned by these methods so you should simply switch to using const
+ methods.
+- wxWindow::GetFont() now returns wxFont object instead of reference
+- EVT_XXX macros are now type-safe; code that uses wrong type for event
+ handler's argument will no longer compile.
+- Identical functionality of wxFileDialog::ParseWildcard,
+ wxGenericDirCtrl::ParseFilter, Motif and MSW parsing native dialogs
+ is now accessible in ::wxParseCommonDialogsFilter
+- wxNotebookSizer and wxBookCtrlSizer are now deprecated -- the are no longer
+ needed, you can treat wxNotebook as any other control and put it directly
+ into the sizer that was wxNotebookSizer's parent sizer in old code.
+
DEPRECATED METHODS SINCE 2.4.x
==============================
-Deprecated methods may still be used but will disappear in future wxWindows
+Deprecated methods may still be used but will disappear in future wxWidgets
versions, please update your code to not use them.
- wxDocManager::GetNoHistoryFiles() renamed to GetHistoryFilesCount()
- wxTheFontMapper: use wxFontMapper::Get() instead
- wxStringHashTable: use wxHashMap instead
- wxHashTableLong: use wxHashMap instead
-- wxArrayString::GetStringArray: use wxCArrayString or alternative wxWindows
+- wxArrayString::GetStringArray: use wxCArrayString or alternative wxWidgets
methods taking wxArrayString
- wxArrayString::Remove(index, count): use RemoveAt instead
- wxTreeItemId conversion to long is deprecated and shouldn't be used
+- wxTreeCtrl::GetFirst/NextChild() 2nd argument now has type wxTreeItemIdValue
+ and not long, please change declarations of "cookie"s in your code
+ accordingly -- otherwise your code won't work on 64 bit platforms
- [MSW only] wxWindow::GetUseCtl3D(), GetTransparentBackground() and
SetTransparent() as well as wxNO_3D and wxUSER_COLOURS styles
- wxList keyed interface: use wxHashMap instead
wxHashTable::compatibility_iterator to store the return
value
- wxWave class; use wxSound instead
+- The wxHIDE_READONLY flag for wxFileDialog was not implemented
+ and has now been removed
+- wxTaskBarIcon::OnXXX() virtual methods: use events instead
OTHER CHANGES
=============
-2.5.1/2.5.2
------------
+2.5.3
+-----
All:
+- number of fixes to wxPluginManager (Rick Brice, Hans Van Leemputten)
+- fixed memory leak in wxURL when using a proxy (Steven Van Ingelgem)
+- fixed bug in wxDateTime::Set(jdn) when DST was in effect
+- fixed fatal bug in wxString when wxUSE_STL==1 (Kurt Granroth)
+- support msgids in charsets other than C and languages other than English
+ (based on patch by Stefan Kowski)
+- added wxMicroSleep() and wxMilliSleep() replacing deprecated wxUsleep()
+
+All (GUI):
+
+- added wxWindow::MoveBefore/AfterInTabOrder() to change tab navigation order
+- added wxTaskBarIcon::CreatePopupMenu which is now recommended way
+ of showing popup menu; calling wxTaskBarIcon::PopupMenu directly
+ is discouraged
+- added ..._CMD_...(id) variants for wxGrid event table entry macros
+- added wxWindow::Navigate for programmatic navigation to the next control.
+- wxTextCtrl::OnChar now inserts a tab character if wxTE_PROCESS_TAB is set
+- added wxKeyEvent::GetUnicodeKey()
+- added wxKeyEvent::CmdDown() and wxMouseEvent::CmdDown()
+
+Unix:
+
+- wxTaskBarIcon now supports freedesktop.org System Tray protocol
+- security fixes to wxSingleInstanceChecker
+- wx-config script was modified to allow choosing from multiple installed
+ builds of wxWidgets
+
+wxGTK:
+
+- fixed many rendering artifacts and wrong colours with lots of GTK+ themes
+- implemented wxColourDialog as native dialog
+- wxTreeCtrl::GetCount() counts root as well now (compatible with MSW)
+- added support for wxCHK_3STATE style (GTK2 only)
+- implemented text underlining under GTK2
+- implemented wxFRAME_NO_TASKBAR style (GTK >= 2.2)
+- implemented support for wxSYS_DCLICK_?, wxSYS_DRAG_? and wxSYS_CURSOR_?
+ in wxSystemSettings::GetMetric (Mart Raudsepp)
+- wxGTK uses GTK+ 2.x by default now, you have to pass --disable-gtk2 to
+ configure if you want to use GTK+ 1.2
+- implemented wxTopLevel::IsMaximized() for GTK+2 and WMs that implement
+ freedesktop.org's wm-spec (Mart Raudsepp)
+
+wxMotif:
+
+- added support for wxCHK_3STATE style (3 state checkbox)
+
+wxMSW:
+
+- fixed UNC paths handling in wxFileSystem (Daniel Nash)
+- set wxKeyEvent::m_uniChar in Unicode build
+
+wxWinCE:
+
+- added automatized but customizable handling of native SmartPhone menus
+
+wxHTML:
+
+- added support for nested index entries and index entries pointing to more
+ than one page to wxHtmlHelpController
+
+
+2.5.2
+-----
+
+All:
+
+- Hindi translation added (Dhananjaya Sharma)
+- Brazilian Portuguese translation added (E. A. Tacao)
+- wxDynamicCast() now uses static_cast<wxObject *> internally and so using it
+ with anything not deriving from wxObject will fail at compile time (instead
+ of run-time) now
+- when wxUSE_STL == 1 and STL provides quasi-standard hash_map/hash_set,
+ wxHashMap/wxHashSet are just typedefs for them. This makes impossible
+ to forward declare these classes.
+
+All (GUI):
+
+- wxHtmlWindow now delays image scaling until rendering,
+ resulting in much better display of scaled images
+- Added UpdateSize to wxSplitterWindow to allow layout while hidden
+- implemented Freeze/Thaw() for wxGenericTreeCtrl (Kevin Hock)
+- support for KOI8-U encoding added (Yuriy Tkachenko)
+- The old wxADJUST_MINSIZE behaviour is now the default behaviour for
+ sizer items that are windows. This means that GetAdjustedBestSize
+ will now be called by default to determine the minimum size that a
+ window in a sizer should have. If you want to still use the initial
+ size (and not the BestSize) then use the wxFIXED_MINSIZE flag. When
+ windows are added to a sizer their initial size is made the window's
+ min size using SetSizeHints, and calls to wxSizer::SetItemMinSize
+ are also forwarded to SetSizeHints for window items.
+- added wxRegEx::GetMatchCount()
+- it is now possible to display images in wxHtmlListBox
+
+wxMSW:
+
+- wxWindow::Freeze()/Thaw() can now be nested
+- Added wxSP_NO_XP_THEME style to wxSplitterWindow to switch off
+ XP theming (some applications look bad without 3D borders)
+- wxMenuBar::GetLabelTop() doesn't include '&'s in the label any more
+- wxRegConf couldn't read global settings without admin privileges and didn't
+ even try to do it by default -- now it does
+- wxTaskBarIcon must be explicitly destroyed now, otherwise the application
+ won't exit even though there are no top level windows
+- wxFileName::GetModificationTime() works with opened files too now
+- wxDC::GetClippingBox() now works even for clipping regions created by Windows
+- fixed wxFileDataObject in Unicode build (Alex D)
+- subdindented paragraphs support (Tim Kosse)
+
+wxGTK:
+
+- added support for wxTE_RIGHT and wxTE_CENTRE styles under GTK2 (Mart Raudsepp)
+
+wxMotif:
+
+- removed wxMenuItem::DeleteSubMenu()
+- wxButtons use Motif default size, which is smaller than it used to be
+ and closer to wxMSW/wxGTK look. This can be disabled by setting
+ motif.largebuttons system option to 1 (see wxSystemOptions).
+
+wxUniv/X11:
+
+- implemented DrawRoundedRectangle() (clawghoul)
+
+wxHTML:
+
+- improved tables and lists layout algorithms (Tim Kosse)
+- <div> handling fix (Xavier Nodet)
+
+Unix:
+
+- fixed priorities of mailcap entries (David Hart)
+- added "wx-config --libs=std,<extra>" syntax (i.e. support for "std")
+
+wxODBC:
+
+- Full Unicode support is now available
+- BLOB support is working
+
+
+2.5.1
+-----
+
+All:
+
+- event table macros now do some minimal type safety checks (Michael Sögtrop)
- added wxGzipInput/OutputStream, bug fixes in wxZlibStreams (M.J.Wetherell)
- wxDateTime::ParseDateTime() implemented (Linus McCabe)
- wxHTTP::GetResponse() added (David Nock)
(as in 2.5.0).
- added some extra convenience functions to wxRect such as
GetBottomRight (Hajo Kirchhoff)
-- Changed built-in regex library to a unicode-compatible one (Ryan Norton)
+- changed built-in regex library to a Unicode-compatible version based
+ on TCL sources (Ryan Norton, M. J. Wetherell)
- added extra convenience functions to wxPoint for adding a
wxSize (Wlodzimierz Skiba)
- intermediate wxIPaddress class added to prepare for
- added wxStatusBar support to XRC (Brian Ravnsgaard Riis)
- wxMenu::Append and etc. return a pointer to the wxMenuItem that was
added or inserted, or NULL on failure.
+- using a -1 (wxID_ANY) for menu or toolbar item IDs will now generate new id
+- added option to generate C++ headers to wxrc utility (Eduardo Marques)
+- added wxDC::DrawPolyPolygon() for MSW/PS (Carl-Friedrich Braun)
+- wxBufferedDC now allows to preserve the background and is documented
+- added wxDC::GetPartialTextExtents
wxMSW:
+- wxWidgets now builds under Win64
- fixed DDE memory leaks
- fixed wxTE_*WRAP styles handling
- wxTextCtrl::GetValue() works with text in non default encoding
- wxComboBox::GetValue within a wxEVT_COMMAND_TEXT_UPDATED event
should now pass the correct value even if the handler for
wxEVT_COMMAND_COMBOBOX_SELECTED changed the selection
-- wxFileDialog now returns correct filter index for multiple-file
- dialogs
+- wxFileDialog now returns correct filter index for multiple-file dialogs
+- added wxTextCtrl::HitTest()
+- experimental wxURL implementation using WinInet functions (Hajo Kirchhoff)
+- fixed several bugs in wxNotebook with wxNB_MULTILINE style
+- accelerators are now initially hidden if appropriate (Peter Nielsen)
+- background colour of a wxComboBox may now be set
+- fixed wxListCtrl::GetItemText/BackgroundColour()
+- Esc can now be used to close menus in the dialogs (Hartmut Honisch)
+- Added msw.remap system option so colourful toolbar buttons
+ aren't mangled if you set it to 0. The default is 1
+- Toolbar buttons are now centred if the bitmap size is smaller
+ than the specified default size
+- Fixed a bug in wxSpinCtrl::DoGetBestSize that would make wxSpinCtrl too tall
wxGTK:
- use same average character width as other ports when calculating dialog units
- fixed mouse wheel handling under GTK2 (Hugh Fisher)
- wxNotebook::HitTest() implemented (Daniel Lundqvist)
+- memory leaks fixes in wxFileDialog (John Labenski)
+- don't drop click events from triple clicks (Frode Solheim)
wxMac:
- fix for long file names (longer than 32 characters) in file dialogs
- use unix sockets for Mach-o builds
+wxMotif:
+
+- look for Motif 2.1 headers before Motif 1.2 ones in configure
+
wxHTML:
- wxHtmlHelpController now supports compressed MS HTML Help files (*.chm)
- added XFree86 resolution changing using xf86vidmode extensions (Ryan Norton)
- implemented asynchronous playback in wxSound and added SDL backend in
addition to existing OSS one
+- it is now possible to send PostScript to any output stream (Zoltan Kovacs)
2.5.0
All:
- It is now possible to build several smaller libraries instead of single
- huge wxWindows library; wxBase is now dependency of GUI ports rather then
+ huge wxWidgets library; wxBase is now dependency of GUI ports rather then
separately compiled library
- added wxDateSpan::operator==() and !=() (Lukasz Michalski)
- added wxFileName::GetForbiddenChars() (Dimitri Schoolwerth)
- improved border handling under Windows XP
- partial fix for wxNotebook pages looking bad under XP: wxUSE_UXTHEME
enables XP theme engine code, and wxUSE_UXTHEME_AUTO tells
- wxWindows to use the theme tab colour for control backgrounds.
+ wxWidgets to use the theme tab colour for control backgrounds.
- disable wxNB_RIGHT, wxNB_LEFT, wxNB_BOTTOM notebook styles under Windows XP
- fixed release mode build with VC 7.x (Martin Ecker)
- added support for wxALWAYS_SHOW_SB style
2.6 release.
NB: if you want to build your program with different major versions
- of wxWindows you will probably find the wxCHECK_VERSION() macro
+ of wxWidgets you will probably find the wxCHECK_VERSION() macro
(see the documentation) useful.
Unix (Base/GUI):
-- wxWindows may be built using BSD and Solaris (and possibly other) make
+- wxWidgets may be built using BSD and Solaris (and possibly other) make
programs and not only GNU make
- wxTCP-based IPC classes now support communicating over Unix domain sockets
-- wxWindows may be built as a dynamic shared library under Darwin / Mac OS X
+- wxWidgets may be built as a dynamic shared library under Darwin / Mac OS X
lazy linking issues have been solved by linking a single module (.o) into
the shared library (two step link using distrib/mac/shared-ld-sh)
- fixed thread priority setting under Linux
- implemented radio menu items and radio toolbar buttons
- added possibility to show text in the toolbar buttons
- added wxArtProvider class that can be used to customize the look of standard
- wxWindows dialogs
+ wxWidgets dialogs
- significantly improved native font support
- wxImage::ComputeHistogram() now uses wxImageHistogram instead of type-unsafe
wxHashTable
- fixed multiple bugs in wxExecute() with IO redirection
- refresh the buttons properly when the window is resized (Hans Van Leemputten)
- huge (40*) speed up in wxMask::Create()
-- changing wxWindows styles also changes the underlying Windows window style
+- changing wxWidgets styles also changes the underlying Windows window style
- wxTreeCtrl supports wxTR_HIDE_ROOT style (George Policello)
- fixed flicker in wxTreeCtrl::SetItemXXX()
- fixed redraw problems in dynamically resized wxStaticText
-- improvements to wxWindows applications behaviour when the system colours
+- improvements to wxWidgets applications behaviour when the system colours
are changed
- choose implicit parent for the dialog boxes better
- fixed wxProgressDialog for ranges > 65535
- Fixed wxFrame::SetClientSize() with toolbar bug
- Added mousewheel processing
- Added wxSystemSettings::Get/SetOption so we can configure
- wxWindows at run time; used this to implement no-maskblt option
+ wxWidgets at run time; used this to implement no-maskblt option
in wxDC
- Fixed bug when using MDIS_ALLCHILDSTYLES style: so now MDI
child frame styles are honoured
fixed handling of relative and absolute font sizes in <font size>
-NOTE: for changes after wxWindows 2.1.0 b4, please see the CVS
+NOTE: for changes after wxWidgets 2.1.0 b4, please see the CVS
change log.
2.1.0, b4, May 9th 1999
- Makefiles for more compilers and samples; Cygwin makefiles
rationalised.
-- Added VC++ project file for compiling wxWindows as DLL.
+- Added VC++ project file for compiling wxWidgets as DLL.
wxMotif:
- Added wxJoystick class and event handling, and simple demo.
- Added simple wxWave class. Needs Stop() function.
- Added wxModule (module.h/module.cpp) to allow definition
- of modules to be initialized and cleaned up on wxWindows
+ of modules to be initialized and cleaned up on wxWidgets
startup/exit.
- Start of Mingw32 compatibility (see minimal and dialogs samples
makefile.m95 files, and install.txt).
- Added wxTaskBarIcon (taskbar.cpp/h, plus samples/taskbar)
to allow maintenance of an icon in the Windows 95 taskbar
tray area.
-- Got MFC sample working (MFC and wxWindows in the same
+- Got MFC sample working (MFC and wxWidgets in the same
application), partly by tweaking ntwxwin.mak settings.
- Got DLL compilation working again (VC++).
- Changed wxProp/Dialog Editor filenames.