X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/014e19de74c30b5421b6906b762e051e020ac391..411165f3f40f411d6feba4d13d4934f7fff6cc4f:/docs/changes.txt diff --git a/docs/changes.txt b/docs/changes.txt index 122b60b42b..b4528c53ba 100644 --- a/docs/changes.txt +++ b/docs/changes.txt @@ -1,19 +1,420 @@ wxWindows 2 Change Log ---------------------- +INCOMPATIBLE CHANGES SINCE 2.2.x +================================ + + Please take a few minutes to read the following list, especially + paying attention to the most important changes which are marked + with '!' in the first column. + + Also please note that you should ensure that WXWIN_COMPATIBILITY_2_2 + is defined to 1 if you wish to retain maximal compatibility with 2.2 + series -- however you are also strongly encouraged to try to compile + your code without this define as it won't be default any longer in + 2.6 release. + + +wxBase: + +! wxArray::Remove(size_t) has been removed to fix compilation problems + under 64 bit architectures, please replace it with RemoveAt() in your + code. + +! wxArray macros have been changed to fix runtime problems under 64 bit + architectures and as a side effect of this WX_DEFINE_ARRAY() can only be + used now for the pointer types, WX_DEFINE_ARRAY_INT should be used for the + arrays containing non-pointers. + +- wxObject::CopyObject() and Clone() methods were removed because they + simply don't make sense for all objects + +- wxEvent now has a pure virtual Clone() method which must be implemented + by all derived classes, if you have user-defined event classes please + add "wxEvent *Clone() const { return new MyEvent(*this); }" line to them + +- small change to wxStopWatch::Pause() semantics, please see the documentation + +- unlikely but possible incompatibility: the definition of TRUE has changed + from "1" to "(bool)1" (and the same thing for FALSE), so the code which + could be erroneously compiled previously such as doing "return FALSE" from + a function returning a pointer would stop compiling now (but this change + is not supposed to have any effects on valid code) + +- another minor change: wxApp::OnAssert() has a new "cond" argument, you + must modify YourApp::OnAssert() signature if you were using it to override + the default assert handling. + + +All (GUI): + +! the event type constants are not constants any more but are dynamically + allocated during run-time which means that they can't be used as case labels + in the switch()es, you must rewrite them to use if()s instead + + You may also define WXWIN_COMPATIBILITY_EVENT_TYPES to get the old behaviour + but this is strongly discouraged, please consider changing your code + instead! + +! wxDialog does not derive from wxPanel any longer - if you were using it in + your code, please update it. The quick fix for the most cases is to replace + the occurrences of wxPanel with wxWindow. + +! if you handle (and don't skip) EVT_KEY_DOWN, the EVT_CHAR event is not + generated at all, so you must call event.Skip() in your OnKeyDown() if + you want to get OnChar() as well + +- wxYES_NO is now wxYES | wxNO and the manifest values of both wxYES and wxNO + have changed (to fix some unfortunate clashes), please check your code to + ensure that no tests for wxYES or wxNO are broken: for example, the following + will *NOT* work any longer: + + if ( flags & wxYES_NO ) + ... do something ... + if ( flags & wxYES ) + ... do something else ... + +- wxGLCanvas now derives directly from wxWindow, not wxScrolledWindow + +- wxGridCellAttrProvider class API changed, you will need to update your code + if you derived any classes from it + +- wxImage::ComputeHistogram()'s signature changed to + unsigned long ComputeHistogram(wxImageHistogram&) const + +- wxEvtHandler cannot be copied/assigned any longer - this never worked but + now it results in compile-time error instead of run-time crashes + +- WXK_NUMLOCK and WXK_SCROLL keys no longer result in EVT_CHAR() events, + they only generate EVT_KEY_DOWN/UP() ones + +- the dialogs use wxApp::GetTopWindow() as the parent implicitly if the + parent specified is NULL, use wxDIALOG_NO_PARENT style to prevent this + from happening + +- several obsolete synonyms are only retained in WXWIN_COMPATIBILITY_2_2 mode: + for example, use wxScrolledWindow::GetViewStart() now instead of ViewStart() + and GetCount() instead of Number() in many classes + +- wxCmdLineParser does not use wxLog to output messages anymore. + to obtain the previous behaviour, add + wxMessageOutput::Set(new wxMessageOutputLog); to your program + (you will need to #include ) + +wxMSW: + +! build system changed: setup.h is not a static file in include/wx any more + but is created as part of the build process under lib//wx/include + where is of the form (msw|univ)[dll][u][d]. You'll need to update + the include path in your make/project files appropriately. Furthermore, + xpm.lib is no longer used by wxMSW, it was superseded by the wxXPMDecoder + class. You'll need to remove all references to xpm.lib from your + make/project files. + +- child frames appear in the taskbar by default now, use wxFRAME_NO_TASKBAR + style to avoid it + +- all overloads of wxDC::SetClippingRegion() combine the given region with the + previously selected one instead of replacing it + +- wxGetHomeDir() uses HOME environment variable and if it is set will not + return the programs directory any longer but its value (this function has + never been meant to return the programs directory anyhow) + +- wxHTML apps don't need to include wx/html/msw/wxhtml.rc in resources file + anymore. The file was removed from wxMSW + + +Unix ports: + +! You should use `wx-config --cxxflags` in your makefiles instead of + `wx-config --cflags` for compiling C++ files. CXXFLAGS contains CFLAGS + and the compiler flags for C++ files only, CFLAGS should still be used + to compile pure C files. + + +wxThread and related classes: + +- The thread-related classes have been heavily changed since 2.2.x versions + as the old code had many serious problems. This could have resulted in + semantical changes other than those mentioned here, please review use of + wxThread, wxMutex and wxCondition classes in your code. + +! 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. + +- 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 + documentation for the discussion of the recursive mutexes. + +- wxMutex::IsLocked() doesn't exist any more and should have never existed: + this is was unique example of a thread-unsafe-by-design method. + + +OTHER CHANGES +============= + +2.3.3 +----- + +wxBase: + +- wxSemaphore class added, many fixed to wxCondition and wxThread (K.S. Sreeram) +- fixes to the command line parsing error and usage messages +- modified wxFileName::CreateTempFileName() to open the file atomically + (if possible) and, especially, not to leak the file descriptors under Unix +- memory leak in wxHTTP fixed (Dimitri) +- fixes to AM_PATH_WXCONFIG autoconf macro +- added wxHashMap class that replaces type-unsafe wxHashTable and is modelled + after (non standard) STL hash_map +- wxLocale now works in Unicode mode +- wxLocale can now load message catalogs in arbitrary encoding +- fixed the bug related to the redrawing on resize introduced in 2.3.2 +- added static wxFontMapper::Get() accessor (use of wxTheFontMapper is now + deprecated) +- added wxShutdown() function (Marco Cavallini) +- added wxEXPLICIT macro + +Unix (Base/GUI): + +- wxWindows 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 + 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 + +All (GUI): + +- it is now possible to set the icons of different sizes for frames (e.g. a + small and big ones) using the new wxIconBundle class +- 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 +- significantly improved native font support +- wxImage::ComputeHistogram() now uses wxImageHistogram instead of type-unsafe + wxHashTable +- added IFF image handler +- fixed using custom renderers in wxGrid which was broken in 2.3.2 +- support for multiple images in one file added to wxImage (TIFF, GIF and ICO formats) +- support for CUR and ANI files in wxImage added (Chris Elliott) +- wxTextCtrl::GetRange() added +- added wxGetFontFromUser() convenience function +- added EVT_MENU_OPEN and EVT_MENU_CLOSE events +- added Hungarian translations (Janos Vegh) +- added wxImage::SaveFile(filename) method (Chris Elliott) +- added wxImage::FloodFill and implemented wxWindowDC::DoFloodFill method + for GTK+, Mac, MGL, X11, Motif ports (Chris Elliott) +- added (platform-dependent) scan code to wxKeyEvent (Bryce Denney) +- added wxTextCtrl::EmulateKeyPress() +- Added wxMouseCaptureChangedEvent +- Added custom character filtering to wxTextValidator +- wxTreeCtrl now supports incremental keyboard search +- wxHelpProvider::RemoveHelp added and called from ~wxWindowBase + so that erroneous help strings are no longer found as the hash + table fills up +- updated libpng from 1.0.3 to 1.2.4 +- Added wxView::OnClosingDocument so the application can do + cleanup. +- generic wxListCtrl renamed to wxGenericListCtrl, wxImageList + renamed to wxGenericImageList, so they can be used on wxMSW + (Rene Rivera). + +wxMSW: + +- small appearance fixes for native look under Windows XP +- 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 +- 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 + are changed +- fixed wxProgressDialog for ranges > 65535 +- wxSpinButton and wxSpinCtrl now support full 32 bit range (if the version + of comctl32.dll installed on the system supports it) +- wxFontEnumerator now returns all fonts, not only TrueType ones +- bugs in handling wxFrame styles (border/caption related) fixed +- showing a dialog from EVT_RADIOBUTTON handler doesn't lead to an infinite + recursion any more +- wxTextCtrl with wxTE_RICH flag scrolls to the end when text is appended to it +- the separators are not seen behind the controls added to the toolbar any more +- 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) +- Implemented wxMouseCaptureChangedEvent and made wxGenericDragImage check it + has the capture before release it. +- fixed bugs in multiple selection wxCheckListBox +- default button handling is now closer to expected +- setting tooltips for wxSlider now works +- multiple events avoided in wxComboBox +- tooltip asserts avoided for read-only wxComboBox +- fixed a race condition during a thread exit and a join +- fixed a condition where a thread can hang during message/event processing +- increased space between wxRadioBox label and first radio button +- don't fail to register remaining window classes if one fails to register + +wxGTK: + +- wxDirDialog now presents the file system in standard Unix way +- wxButton now honours wxBU_EXACTFIT +- wxStaticBox now honours wxALIGN_XXX styles +- added support for non alphanumeric simple character accelerators ('-', '=') +- new behaviour for wxWindow::Refresh() as it now produces a delayed refresh. + Call the new wxWindow::Update() to force an immediate update +- support for more SGI hardware (12-bit mode among others) +- fixed wxDC::Blit() to honour source DC's logical coordinates +- implemented wxIdleEvent::RequestMore() for simple background tasks +- implemented wxChoice::Delete() +- fixed bad memory leak in wxFileDialog (Chris Elliott) +- made internal GC pool dynamically growable + +wxMotif: + +- improved colour settings return values (Ian Brown) +- improved border style handling for wxStaticText (Ian Brown) +- improved toolbar control alignment +- implemented wxSpinButton +- implemented wxCheckListBox +- fixed wxSpinCtrl and wxStaticLine when used with sizers +- wxStaticBitmap now shows transparent icons correctly + +wxHTML: + +- fixed wxHtmlHelpController's cache files handling on big endian machines +- added blocking and redirecting capabilities to wxHtmlWindow via + wxHtmlWindow::OnOpeningURL() +- fixed alignment handling in tables +- fixed handling to be case insensitive + +2.3.2 +----- + +New port: wxUniv for Win32/GTK+ is now included in the distribution. + +wxBase: + +- wxRegEx class added +- wxGetDiskSpace() function added (Jonothan Farr, Markus Fieber) +- wxTextBuffer and wxTextFile(wxStream) added (Morten Hanssen) +- more fixes to wxMBConv classes. Conversion to and from wchar_t now works with + glibc 2.2 as well as with glibc 2.1. Unix version now checks for iconv()'s + capabilities at runtime instead of in the configure script. + +All (GUI): + +- support for virtual list control added +- column images in report mode of the list control +- wxFindReplaceDialog added (based on work of Markus Greither) +- wxTextCtrl::SetMaxLength() added (wxMSW/wxGTK) +- polygon support in wxRegion (Klaas Holwerda) +- wxStreamToTextRedirector to allow easily redirect cout to wxTextCtrl added +- fixed bug with using wxExecute() to capture huge amounts of output +- new wxCalendarCtrl styles added (Søren Erland Vestø) +- wxWizard changes: loading from WXR support, help button (Robert Cavanaugh) +- wxDirSelector() added (Paul A. Thiessen) +- wxGrid cell editing veto support (Roger Gammans) +- wxListCtrl ITEM_FOCUSED event added +- support for ICO files in wxImage added (Chris Elliott) +- improvements to wxDragImage (Chuck Messenger) + +wxMSW: + +- support for the DBCS fonts (CP 932, 936, 949, 950) (Nathan Cook) +- new library naming convention under VC++ -- please change your application + project files + +wxGTK: + +- fixed popup menu positioning bug +- fixed the edit function for wxListCtrl (Chuck Messenger) +- fixed the key-hitting events for wxListCtrl and wxTreeCtrl, so they + correctly return the key which was pressed (Chuck Messenger) + +wxMac: + +- support for configuration and build under Mac OS X using the Apple Developer + Tools + +wxHTML: + +- new HTML parser with correct parsing of character entities and fixes + to tags parsing +- added support for animated GIFs + 2.3.1 ----- +wxBase: + +- Fixes for gcc 3.0 +- Fixed new charset detection code +- ODBC Informix fixes (submitted by Roger Gammans) +- Added ODBC date support to wxVariant +- Added wxDir::Traverse +- Added wxSingleInstanceChecker class +- Removed redundant wxDebugContext functions using C++ streams, + so now standard stream usage should be unnecessary + All (GUI): +- Added wxDbGrid class for displaying ODBC tables - Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user code can get access to the edit control when it is created, (to - push on a custom event handler for example.) + push on a custom event handler for example) - Added wxTextAttr class and SetStyle, SetDefaultStyle and - GetDefaultStyle methods to wxTextCtrl. + GetDefaultStyle methods to wxTextCtrl +- Added wxSingleInstanceChecker +- Improvements to Tex2RTF +- Added Paul and Roger Gammans' grid controls +- Bug in wxDocument::Save logic corrected, whereby Save didn't save when not + first-time saved +- Fixed memory leak in textcmn.cpp +- Various wxXML enhancements +- Removed wxCLIP_CHILDREN style from wxSplitterWindow +- Fixed memory leak in DoPrint, htmprint.cpp +- Fixed calendar sample bug with using wxCommandEvent::GetInt() + instead of GetId() +- Added wxDbGrid combining wxODBC classes with wxGrid +- Added more makefiles and project files for contrib hierarchy +wxMSW: +- Fixed wxApp::ProcessMessage so controls don't lose their + accelerators when the accelerators are redefined elsewhere +- Accelerators consisting of simple keystrokes (without control, + alt or shift) now work +- Compile fixes for Watcom C++ added +- Compile fixes for Cygwin 1.0 added +- Use SetForegroundWindow() in wxWindow::Raise() instead of BringWindowToTop() +- Replaced wxYield() call in PopupMenu() by a much safer + wxYieldForCommandsOnly() - fixes tree ctrl popup menu bug and other ones +- Enter processing in wxSpinCtrl fixed +- Fixed bug in determining the best listbox size +- Fix for wxFrame's last focus bug +- We now send iconize events +- 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 + in wxDC +- Fixed bug when using MDIS_ALLCHILDSTYLES style: so now MDI + child frame styles are honoured +wxGTK: + +- Fixed slider rounding bug +- Added code to set wxFont's default encoding to wxLocale::GetSystemEncoding() +- We now send iconize events +- Fix for discrepancies between wxNotebookEvent and wxNotebook + GetSelection() results 2.3.0 ----- @@ -30,12 +431,11 @@ wxBase: - wxLocale now provides much more convenient API for setting language and detecting current system language. New API is more abstracted and truly cross-platform, independent of underlying C runtime library. -- wxDir::Traverse() added All (GUI): - new wxToggleButton class (John Norris, Axel Schlueter) -- wxCalendarCtrl now highlighting the date with time part bug fixed +- wxCalendarCtrl not highlighting the date with time part bug fixed - wxADJUST_MINSIZE sizer flag added - FindOrCreateBrush/Pen() bug fix for invalid colour values - new wxXPMHandler for reading and writing XPM images @@ -49,13 +449,12 @@ All (GUI): - ODBC NULL column support completed (Roger/Paul Gammans) - ODBC All "char *" and char arrays removed and replaced with wxString use - wxMSW: - threads: bug in wxCondition::Broadcast fixed (Pieter van der Meulen) - fixed bug in MDI children flags (mis)handling -- it is possible to compile wxCHMHelpController with other compilers than VisualC++ - now and hhctrl.ocx is loaded at runtime. +- it is possible to compile wxCHMHelpController with compilers + other than Visual C++ now and hhctrl.ocx is loaded at runtime wxGTK: @@ -121,7 +520,7 @@ wxMSW: - fixed "missing" initial resize of wxMDIChildFrame - wxFrame restores focus better - Now ignore wxTHICK_FRAME in wxWindow constructor: only relevant to - frames anddialogs, interferes with other window styles otherwise + frames and dialogs, interferes with other window styles otherwise (sometimes you'd get a thick frame in a subwindow) - wxTextCtrl insertion point set to the beginning of the control by SetValue - Fix so wxMDIParentFrame is actually shown when Show(TRUE) is called. @@ -204,7 +603,7 @@ all (GUI): - Added wxImage::Rotate. - new wxCalendarCtrl class for picking a date interactively -- wxMenu(Bar)::Insert() and Remove() functions for dynamic menu menagament +- wxMenu(Bar)::Insert() and Remove() functions for dynamic menu management - wxToolBar supports arbitrary controls (not only buttons) and can be dynamically changed (Delete/Insert functions) - vertical toolbars supported by MSW and GTK native wxToolBar classes @@ -220,7 +619,7 @@ all (GUI): - wxScrolledWindow now has keyboard interface - wxTextEntryDialog may be used for entering passwords (supports wxTE_PASSWORD) - added wxEncodingConverter and improved wxFontMapper - for dealing with convertions between different encodings, + for dealing with conversions between different encodings, charsets support in wxLocale and wxHTML - wxDragImage class added - samples/help improved to show standard and advanced HTML help @@ -262,11 +661,11 @@ wxHTML: including faster search, bookmarks, printing, setup dialog and cross-platform binary compatible .cached files for faster loading of large helpbooks, case insensitive search - splitted into 3 parts: wxHtmlHelpData, Frame and Controller + split into 3 parts: wxHtmlHelpData, Frame and Controller - added support for charsets and tag - added support for font faces and justified paragraphs, taken some steps to prepare wxHTML for frames -- added dynamic pushing/poping of wxHtmlParser tag handlers +- added dynamic pushing/popping of wxHtmlParser tag handlers - improved HTML printing - added extensive table of HTML characters substitutions (  etc.) - fixed wxHtmlWindow flickering, several minor bugfixes @@ -529,7 +928,7 @@ wxMotif: global memory operators (usually OK) and #defining new to be WXDEBUG_NEW (sometimes it might not be OK). - Added time.cpp to makefile; set wxUSE_DATETIME to 1. -- Added a parent-existance check to popup menu code to make it not crash. +- Added a parent-existence check to popup menu code to make it not crash. - Added some optimization in wxWindow::SetSize to produce less flicker. It remains to be seen whether this produces any resize bugs. @@ -585,7 +984,7 @@ wxMSW: - wxConfig API improved, documentation updated. - Printing classes name conventions cleaned up. - wxUpdateUIEvent now derives from wxCommandEvent - so event can travel up the window hierachy. + so event can travel up the window hierarchy. Alpha 14, July 31st 1998 ------------------------ @@ -846,7 +1245,7 @@ Generic: - Added wxMouseEvent::GetPosition and wxMouseEvent::GetLogicalPosition, both returning wxPoints. - Made wxSize and wxRect contain longs not ints. -- Cured some lemory leaks (thanks Vadim). +- Cured some memory leaks (thanks Vadim). - Tidied up OnIdle and introduced RequestMore/MoreRequested so will only keep processing OnIdle if it returns TRUE from MoreRequested. @@ -875,7 +1274,7 @@ All: implementation updated to use these base classes. - wxHelpInstance now separated into wxHelpControllerBase (base for all implementations), wxWinHelpController (uses standard - WinHelp), wxXLPHelPController (talks to wxHelp by DDE or + WinHelp), wxXLPHelpController (talks to wxHelp by DDE or TCP/IP). There will be others eventually, such as wxHTMLHelpController for Microsoft (and Netscape?) HTML Help. - Added Vadim Zeitlin's wxString class plus @@ -956,7 +1355,7 @@ At this point, the following has been achieved: Windows types where needed e.g. WXHWND. - PrologIO revised. - wxScrolledWindow, wxStatusBar and new MDI classes added. - MDI is now achived using separate classes, not window styles. + MDI is now achieved using separate classes, not window styles. - wxSystemSettings added, and made use of to reflect standard Windows settings. - SetButtonFont/SetLabelFont replaced by SetFont; font and colour