X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/9e152a55785098472ca1c0df110ad0a1203f710f..a2c6537e60ab5564d6bf33bb14ac8c42744aa93c:/docs/changes.txt diff --git a/docs/changes.txt b/docs/changes.txt index 7ef22a1045..2b8bf2bd60 100644 --- a/docs/changes.txt +++ b/docs/changes.txt @@ -17,6 +17,93 @@ INCOMPATIBLE CHANGES SINCE 2.4.x 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 @@ -50,13 +137,19 @@ INCOMPATIBLE CHANGES SINCE 2.4.x the only incompatibility being that Next() returns a wxHashTable::Node* instead of a wxNode*. - non-const wxDC methods GetBackground(), GetBrush(), GetFont() and GetPen() - 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. + 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 and - wxGenericDirCtrl::ParseFilter is now accessible in ::wxParseWildcard +- 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. @@ -105,33 +198,64 @@ OTHER CHANGES 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_... variants for wxGrid event table entry macros - taking window identifiers -- Added wxWindowBase::Navigate for programmatic navigation to the next - control. -- On most platforms, wxTextCtrl::OnChar now inserts a tab character if - wxTE_PROCESS_TAB is set, or navigates to the next control if not. +- 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 3 state checkbox +- 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