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.
+
wxBase:
-- wxArray<T>::Remove(size_t) has been removed to fix compilation problems
+! 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
+! 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.
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
- unlikely but possible incompatibility: the definition of TRUE has changed
All (GUI):
-- the event type constants are not constants any more but are dynamically
+! 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
+ 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
+! 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.
+ 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
- wxGLCanvas now derives directly from wxWindow, not wxScrolledWindow
-- if you handle (and don't skip) EVT_KEY_DOWN, the EVT_CHAR event is not
- generated at all
-
- wxGridCellAttrProvider class API changed, you will need to update your code
if you derived any classes from it
wxMSW:
-- build system changed: setup.h is not a static file in include/wx any more
+! 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,
- 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
+! 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
=============
- 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.
- 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
- 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
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 <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
+- 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
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.
- 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
------------------------
- 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.
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
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
projects / wxWidgets.git / blobdiff