X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/adbf2d732fe5f254f45ab27530e4f9c044cb385f..c0b0635cf69537ca32377bad5650b39402cb21b6:/docs/changes.txt diff --git a/docs/changes.txt b/docs/changes.txt index 35cb4de59d..787f7f6fe3 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 + recalculated 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 @@ -43,7 +130,7 @@ INCOMPATIBLE CHANGES SINCE 2.4.x 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, + 2.4.x version of wxZlibOutputStream. However, there is a compatibility 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), @@ -54,15 +141,21 @@ INCOMPATIBLE CHANGES SINCE 2.4.x 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 +- wxNotebookSizer and wxBookCtrlSizer are now deprecated -- they 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. - +- wxFile methods now return either wxFileOffset or wxFileSize_t which may be a + 64 bit integer type, even on 32 bit platforms, instead of off_t and so the + return value of wxFile::Length(), for example, shouldn't be assigned to off_t + variable any more (the compiler might warn you about this) +- wxListItem::m_data is now of type wxUIntPtr, not long, for compatibility + with 64 bit systems DEPRECATED METHODS SINCE 2.4.x @@ -99,56 +192,179 @@ versions, please update your code to not use them. - The wxHIDE_READONLY flag for wxFileDialog was not implemented and has now been removed - wxTaskBarIcon::OnXXX() virtual methods: use events instead +- obsolete and not used wxUSE_GENERIC_DIALOGS_IN_MSW has been removed +- wxDbTable::wxDbTable with wxChar* deprecated, same with wxString& instead OTHER CHANGES ============= +2.5.4 +----- + +All: + +- Norwegian (Bokmål) translation added (Hans F. Nordhaug) +- wxDynamicLibrary::HasSymbol() added +- added wxTextInputStream::operator>>(wchar_t) for compilers which support this + +All (GUI): + +- recursive wxSizer::GetItem returns item of given window, sizer or nth index +- wxLayoutConstraints now use best size, not current size, for AsIs() condition + +Unix: + +- wxPuts() now correctly outputs trailing new line in Unicode build + +wxGTK: + +- fixed wxFileDialog::SetWildcard() + +wxMac: + +- wxDynamicLibrary::GetDllExt() now returns ".bundle", not ".dylib" +- wxDynamicLibrary::GetSymbol() now prepends underscore to the symbol name + +wxMSW: + +- fixed enhanced metafiles loading from files (Andreas Goebel) +- Group of wxRadioButtons no longer have to be consecutive + + 2.5.3 ----- All: +- support for huge (>2 Gb) files (Tim Kosse) - 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 -- it's now possible to use msgids in other languages than English with - wxLocale (based on patch by Stefan Kowski) +- 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() +- basic UDP sockets support (Lenny Maiorani) +- fixed wxDateTime::GetWeekDayName() for some dates (Daniel Kaps) +- deprecated wxDateTime::SetToTheWeek() in favour of SetToWeekOfYear() +- active mode support in wxFTP (Randall Fox) +- sped up wxHTTP and wxFTP +- added wxStringInput/OutputStreams +- added wxFileConfig::Save(wxOutputStream) +- fixed wxString's behavior with inserted null characters All (GUI): -- added wxTaskBarIcon::CreatePopupMenu which is now recommended way - of showing popup menu; calling wxTaskBarIcon::PopupMenu directly +- added wxWindow::MoveBefore/AfterInTabOrder() to change tab navigation order +- added wxTaskBarIcon::CreatePopupMenu which is now the recommended way + of showing a 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() +- implemented wxListCtrl::FindItem() for non-MSW (Robin Stoll) +- added status bar fields styles support (Tim Kosse) +- added convenience functions wxSizer::AddSpacer() and + wxSizer::AddStretchSpacer() (as well as Prepend and Insert variants) +- added samples/splash +- added support for stock buttons +- added wxTopLevelWindow::RequestUserAttention() +- support for comma in contrib gizmo wxLEDNumberCtrl (Grant Likely) +- recursive wxSizer::Show for subsizer and return value if element was found +- added wxChoicebook control +- smoother time estimation updates in wxProgressDialog (Christian Sturmlechner) +- the XRC contrib library was moved to the core +- wx(Choice/List/Note)book controls send CHANG(ED/ING) events in SetSelection +- it is now possible to create a wxFont with given size in pixels (d2walter) +- added wxTopLevelWindow::IsActive() +- wxSystemSettings::GetMetric now returns -1 for metrics that are not + supported, instead of zero. 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 and to return flags/libs for selected libraries only +- wx-config has new --version-full option + +wxCocoa: + +- added Unicode compatibility layer for OSX 10.2 +- fixed so that wxCocoa runs in OSX 10.2 +- Tooltips now supported +- wxSound now supported +- wxDisplay now supported +- Some stock cursors now supported + +wxMac: + +- fixed MLTE text control GetLineText and GetLineLength on OSX +- added OSX wxTaskBarIcon implementation for the OSX Dock +- added Unicode compatibility layer for OSX 10.2 +- wxGetKeyState now works with nearly all wx key codes wxGTK: +- wxGTK uses GTK+ 2.x by default now, you have to pass --disable-gtk2 to + configure if you want to use GTK+ 1.2 - fixed many rendering artifacts and wrong colours with lots of GTK+ themes - implemented wxColourDialog as native dialog +- implemented wxTextCtrl::HitTest() (GTK+ >= 2) +- implemented wxTextCtrl::ScrollLines() and ScrollPages for GTK+ 2.x - 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) +- implemented wxTopLevel::IsMaximized() for GTK+2 and WMs that implement + freedesktop.org's wm-spec (Mart Raudsepp) +- wxEVT_CONTEXT_MENU is now generated for right mouse press, not release +- implemented alpha channel support in wxBitmap +- added native GTK+2 wxArtProvider implementation with ability to load + icons from icon theme in addition to recognized stock art +- fixed crash on 64 bit platforms (Paul Cornett) 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 +- support for alpha channel in toolbar bitmaps (Jurgen Doornik) +- wxFileDialog can now be moved and centered (Randall Fox) +- restored (and improved) possibility to use wx with MFC broken in 2.5.2 +- fixed wxTextCtrl::SetMaxLength for rich edit controls +- fixed flat style for toolbars under XP, Windows Classic style +- fixed truncation of transferred data in wxConnection under unicode build +- wxChoice and wxComboBox dropdown background can be set now too (Adrian Lupei) +- fixed wxMaximizeEvent generation in wxFrame +- don't send duplicate EVT_COMBOBOX events whenever selection changes any more +- implemented support for selecting printer bin (Steven Van Ingelgem) +- fixed wxListCtrl::SetSingleStyle() which was broken since a few releases +- fixed print setup problem (always uses default printer) in Unicode build + +wxUniv/X11: + +- fixed fatal crash when opening a menu wxWinCE: -- added automatized but customizable handling of native SmartPhone menus +- added native WinCE driven smartphone wxTextCtrl implementation using spinners +- added native WinCE driven smartphone wxChoice implementation using spinners +- added automated but customizable handling of native WinCE driven smartphone menus +- fixed wxRadioBox and wxStaticBox + +wxHTML: + +- added support for nested index entries and index entries pointing to more + than one page to wxHtmlHelpController 2.5.2 @@ -196,7 +412,7 @@ wxMSW: - 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) +- subindented paragraphs support (Tim Kosse) wxGTK: @@ -263,7 +479,6 @@ All: All (GUI): -- added wxListBook control - added 3-state checkboxes for MSW/Mac (Dimitri Schoolwerth) - added some support for C++ exceptions in the library (do read the manual!) - added wxListCtrl::GetViewRect() @@ -340,7 +555,7 @@ wxMac: - use same average character width as other ports when calculating dialog units - implemented handling of mouse wheel - fix for long file names (longer than 32 characters) in file dialogs -- use unix sockets for Mach-o builds +- use Unix sockets for Mach-o builds wxMotif: @@ -404,7 +619,7 @@ wxBase: All GUI ports: - added wxVScrolledWindow, wxVListBox and wxHtmlLbox classes -- added wxListbook +- added wxListbook control - added alpha channel support to wxImage - added wxRenderer class allowing to customize the drawing of generic controls - added wxCLOSE_BOX style for dialogs and frames @@ -424,7 +639,7 @@ All GUI ports: - it is now possible to use several wxFileHistory objects in the same menu by giving them different base IDs (Dimitri Schoolwerth) - Added wxTLW::SetShape with implementations for wxMSW and wxGTK (so far) -- FL: rmoved const from EnableTool parameters +- FL: removed const from EnableTool parameters - FL: signal child window when toolbar is closed - In various places, changed tests for pathsep on last char of string to call wxEndsWithPathSeparator(s) @@ -498,7 +713,7 @@ wxGTK: - added wxTextCtrl::SetSelection implementation for GTK+ 2 - fixed wxTextCtrl::IsEditable() for GTK+ 2 - fixed wxStaticText alignment for GTK+ 2 (Kevin Hock) -- don't consume 100% CPU when showing a poup menu +- don't consume 100% CPU when showing a popup menu wxMac: @@ -522,7 +737,7 @@ wxMSW: - libraries built with makefile.g95 have a _min or _cyg suffix (MinGW/Cygwin) - when using DLL, wxLocalFSHandler was not being exported - fixed problem with wxEvtHandler object not removed from wxPendingEvents -- Windows XP manifest is now included in wx.rc; it is no longer neccessary +- Windows XP manifest is now included in wx.rc; it is no longer necessary to ship .exe.manifest file with applications to support XP themes - wxLocale::Init no longer reports error if trying to set Unicode-only locale or if user's default locale is Unicode-only @@ -722,7 +937,7 @@ wxThread and related classes: ! wxCondition now *must* be used with a mutex, please read the (updated) class documentation for details and revise your code accordingly: this change was unfortunately needed as it was impossible to ensure the correct behaviour - (i.e. absense of race conditions) using the old API. + (i.e. absence of race conditions) using the old API. - wxMutex is not recursive any more in POSIX implementation (it hasn't been recursive in 2.2.x but was in 2.3.1 and 2.3.2), please refer to the class @@ -872,7 +1087,7 @@ wxMSW: - wxLB_SORT style can be used with wxCheckListBox - wxWindowDC and wxClientDC::GetSize() works correctly now - Added wxTB_NODIVIDER and wxTB_NOALIGN so native toolbar can be used in FL -- Multiline labels in buttons are now supoprted (simply use "\n" in the label) +- Multiline labels in buttons are now supported (simply use "\n" in the label) - Implemented wxMouseCaptureChangedEvent and made wxGenericDragImage check it has the capture before release it. - fixed bugs in multiple selection wxCheckListBox @@ -2017,7 +2232,7 @@ At this point, the following has been achieved: - Toolbar class hierarchy revised: wxToolBarBase wxToolBarSimple (= old wxToolBar) - wxToolBar95 (= old wxButtonBar under Win95 + wxToolBar95 (= old wxButtonBar under Win95) wxToolBarMSW (= old wxButtonBar under WIN16/WIN32) - Constraint system debugged somewhat (sizers now work properly). - wxFileDialog, wxDirDialog added; other common dialogs now