]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/changes.txt
test wxExecute() in the sample
[wxWidgets.git] / docs / changes.txt
index 79e3fb59373d539d4e58d9b549849a754bb7939a..4fd63579219c22e063b6ceea67b6105be3861ad5 100644 (file)
 wxWindows 2 Change Log
 ----------------------
 
-next release (2.1.12 or 2.2?)
------------------------------
+INCOMPATIBLE CHANGES SINCE 2.2.x
+================================
 
-all:
+wxBase:
 
-- wxStopWatch class, timer functions have more chances to return correct
-  results for your platform (use ANSI function where available)
+- wxArray<T>::Remove(size_t) has been removed to fix compilation problems
+  under 64 bit architectures, please replace it with RemoveAt() in your
+  code.
+
+- wxArray<T> 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
+
+- 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 the old class didn't behave correctly in all cases
+
+- small change to wxStopWatch::Pause() semantics, please see the documentation
+
+
+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 codei
+  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 occurences of wxPanel with wxWindow.
+
+- 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
+
+
+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/<toolkit>/wx/include
+  where <toolkit> 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, wxFRAME_FLOAT_ON_PARENT style is now obsolete and has no
+  effect
+
+- 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.
+
+
+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)
+
+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
+
+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()
+
+wxMSW:
+
+- small appearance fixes for native look under Windows XP
+- 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
+- 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)
+
+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
+  (unlike thread work)
+- implemented wxChoice::Delete()
+
+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 <font face="..."> 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)
+
+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
+
+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)
+- Added wxTextAttr class and SetStyle, SetDefaultStyle and
+  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
+-----
+
+wxBase:
+
+- fixed problem with wxURL when using static version of the library
+- wxZipFSHandler::FindFirst() and FindNext() now correctly list directories
+- wxMimeTypesManager now can create file associations too (Chris Elliott)
+- wxCopyFile() respects the file permissions (Roland Scholz)
+- wxFTP::GetFileSize() added (Søren Erland Vestø)
+- wxDateTime::IsSameDate() bug fixed
+- wxTimeSpan::Format() now behaves more as expected, see docs
+- 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.
+
+All (GUI):
+
+- new wxToggleButton class (John Norris, Axel Schlueter)
+- 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
+- added new (now recommended) API for conversion between wxImage and wxBitmap
+  (wxBitmap::ConvertToImage() and wxBitmap::wxBitmap(wxImage&) instead of
+  wxImage methods and ctor)
+- ODBC classes now support DB2, Interbase, and Pervasive SQL
+- ODBC documentation complete!!
+- ODBC classes have much Unicode support added, but not complete
+- ODBC experimental BLOB support added, but not completely tested
+- 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 compilers
+  other than Visual C++ now and hhctrl.ocx is loaded at runtime
+
+wxGTK:
+
+- added support for wchar_t (wxUSE_WCHAR_T) under Unix
+
+wxHTML:
+
+- mew feature, wxHtmlProcessor for on-the-fly modification of HTML markup
+- visual enhancements to contents panel of wxHtmlHelpController
+
+2.2.0
+-----
+
+wxBase:
+
+- Fixed bug with directories with trailing (back)slashes in wxPathExists
+- wxString: added wxArrayString::operator==() and !=()
+- Fixes for wxCmdLineParser
+- Added wxGetLocalTimeMillis
+- Completed Czech translations
+- Some stream corrections
+- added missing consts to wxPoint operators
+- wxDateTime ParseFormat fixes
+- wxFile::Open(write_append) will create file if it doesn't exist
+- small fixes to MIME mailcap test command handling, more MIME tests in the sample
+
+All (GUI):
+
+- wxGenericDragImage now allows virtual image drawing, and
+  flicker-free dragging is now possible
+- Added wxPrinter::GetLastError
+- Fixed wxLogGui reentrancy problem
+- Paper names now translated
+- wxGrid fixes
+- Generic validator now caters for more cases (integers in
+  wxTextCtrl, strings in wxChoice, wxComboBox)
+- Fixed crash when docview On... functions return FALSE. Show
+  error message when an non-existent filename is typed into the Open
+  File dialog.
+- Corrected Baltic font encoding handling
+- wxImage: enhanced TIFF code, added new platform-independent BMP
+  writing code
+- wxKeyEvent::GetKeyCode() and HasModifiers() added and documented
+- Fixed wxPropertyForm crashes in sample
+- wxWizard now calls TransferDataFromWindow() before calling
+  wxWizardPage::GetNext() fixing an obvious bug
+
+wxMSW:
+
+- wxWindow::GetCharWidth/Height now calculated accurately.
+  This will affect all .wxr dialog resources, so for
+  backward compatibility, please set
+  wxDIALOG_UNIT_COMPATIBILITY to 1 in setup.h
+- wxListCtrl: set item text in LIST_ITEM_ACTIVATED events
+- wxTextCtrl: implemented setting colours for rich edit controls
+- wxColour now accepts both grey and gray
+- BC++ DLL compilation fixed
+- Watcom C++ makefiles improved for JPEG and TIFF compilation
+- Fixed submenu accelerator bug
+- Fixed dialog focus bug (crash if the previous window to have
+  the focus was destroyed before the dialog closed)
+- Too-small default wxTextCtrl height fixed
+- 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
+  (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.
+- wxFileDialog: adjusts struct size if there's an error (struct
+  sizes can be different on different versions of Windows)
+- wxImageList::GetSize() documented and added to wxMSW
+- fixed default dialog style to make them non resizeable again
+- fixed wxFrame::IsShown() which always returned TRUE before
+
+wxGTK:
+
+- Please see docs/gtk/changes.txt.
+
+wxMotif:
+
+- Small compilation fixes
+
+Documentation:
+
+- wxCaret documented
+
+2.1.16
+------
+
+wxBase:
+
+All (GUI):
+
+wxMSW:
+
+- Various bug fixes
+- Added wxCHMHelpController, for invoking MS HTML Help
+  files. This works under VC++ only
+- Modal dialog handling improved
+- Printer dialog now modal
+
+wxGTK:
+
+- Various bug fixes
+
+wxMotif:
+
+- Various bug fixes
+
+2.1.15
+------
+
+Documentation:
+
+- Added docs/tech for technical notes
+
+File hierarchy:
+
+- Started new contrib hierarchy that mirrors
+  the main lib structure; moved OGL and MMedia into it
+
+wxBase:
+
+- wxSocket support
+- wxDateTime replaces and extends old wxDate and wxTime classes (still
+  available but strongly deprecated) with many new features
+- wxLongLong class provides support for (signed) 64 bit integers
+- wxCmdLineParser class for parsing the command line (supporting short and
+  long options, switches and parameters of different types)
+- it is now possible to build wxBase under Win32 (using VC++ only so far)
+  and BeOS (without thread support yet)
+- wxThread class modified to support both detached and joinable threads, also
+  added new GetCPUCount() and SetConcurrency() functions (useful under Solaris
+  only so far)
+- wxDir class for enumerating files in a directory
+- wxLog functions are now (more) MT-safe
+- wxStopWatch class, timer functions have more chances to return correct
+  results for your platform (use ANSI functions where available)
+- wxString::ToLong, ToULong, ToDouble methods and Format() static one added
 - buffer overflows in wxString and wxLog classes fixed (if snprintf() function
   is available)
-
-- wxArray::RemoveAt() replaces deprectaed wxArray::Remove(index)
+- wxArray::RemoveAt() replaces deprecated wxArray::Remove(index)
+
+all (GUI):
+
+- Added wxImage::Rotate.
+- new wxCalendarCtrl class for picking a date interactively
+- wxMenu(Bar)::Insert() and Remove() functions for dynamic menu menagament
+- 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
+- wxTreeCtrl and wxListCtrl allow setting colour/fonts for individual items
+- "file open" dialog allows selecting multiple files at once (contributed by
+  John Norris)
+- wxMimeTypesManager uses GNOME/KDE MIME database to get the icons for the
+  MIME types if available (Unix only)
+- wxDC::DrawRotatedText() (based on contribution by Hans-Joachim Baader)
+- TIFF support added (libtiff required and included in the distribution)
+- PCX files can now be written (256 and 24 bits)
+- validators may work recursively if wxWS_EX_VALIDATE_RECURSIVELY is set
+- 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,
+  charsets support in wxLocale and wxHTML
+- wxDragImage class added
+- samples/help improved to show standard and advanced HTML help
+  controllers, as well as native help
+- moved wxTreeLayout class to main lib
 
 wxMSW:
 
-- arbitrary controls (and not only buttons) can be put into a toolbar
+- wxFrame::MakeFullScreen added.
+- support for enhanced metafiles added, support for copying/pasting metafiles
+  (WMF and enhanced ones) fixed/added.
+- implemented setting colours for push buttons
+- wxStatusBar95 may be now used in dialogs, panels (not only frames) and can be
+   positioned along the top of the screen and not only at the bottom
+- wxTreeCtrl::IsVisible() bug fixed (thanks to Gary Chessun)
+- loading/saving big (> 32K) files in wxTextCtrl works
+- tooltips work with wxRadioBox
+- wxBitmap/wxIcon may be constructed from XPM included into a program, as in
+  Unix ports
+- returning FALSE from OnPrintPage() aborts printing
+- VC++ makefiles and project files made (mostly) consistent
+- wxSetCursorEvent added
 
 wxGTK:
 
 - wxFontMapper endless recursion bug (on some systems) fixed
 - wxGTK synthesizes wxActivateEvents
-- you can use UpdateUI handlers with wxTextCtrl
+- UpdateUI handlers may be used with wxTextCtrl
+
+wxMotif:
+
+- wxMenu::Enable works
+- wxToolBar bugs fixed
+- OGL samples made to work again
+
+wxHTML:
+
+- almost complete rewrite of wxHtmlHelpController,
+  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
+- added support for charsets and <meta> 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
+- improved HTML printing
+- added extensive table of HTML characters substitutions (&nbsp; etc.)
+- fixed wxHtmlWindow flickering, several minor bugfixes
+- added some tags: <address>, <code>, <kbd>, <samp>, <small>, <big>,
+  fixed handling of relative and absolute font sizes in <font size>
+
 
 NOTE: for changes after wxWindows 2.1.0 b4, please see the CVS
 change log.
 
-Major improvements are listed in readme.txt.
-
 2.1.0, b4, May 9th 1999
 -----------------------