\section{Changes since 2.4.x}\label{changes}
-Listed here are the depreciated and incompatable changes made to wxWidgets.
+Listed here are the depreciated and incompatible changes made to wxWidgets.
For other changes (such as additional features, bug fixes, etc.) see the changes.txt file located in the docs directory of your wxWidgets directory.
-\subsection{Incompatable changes since 2.4.x}\label{incompatiblesince24}
+\subsection{Incompatible changes since 2.4.x}\label{incompatiblesince24}
\subsubsection{New window repainting behaviour}\label{newwindowrepainting}
\subsubsection{Massive wxURL Rewrite}\label{wxurlrewrite}
-wxURL has undergone some radical changes.
+\helpref{wxURL}{wxurl} has undergone some radical changes.
\begin{itemize}\itemsep=0pt
-\item Many accessors of wxURL - GetHostName, GetProtocolName, and GetPath,
- have been replaced by its parent's (wxURI) counterparts - GetServer,
- GetScheme, and GetPath, respectively.
+\item Many accessors of \helpref{wxURL}{wxurl} - GetHostName, GetProtocolName, and GetPath,
+ have been replaced by its parent's (\helpref{wxURI}{wxuri}) counterparts - \helpref{GetServer}{wxurigetserver},
+ \helpref{GetScheme}{wxurigetscheme}, and \helpref{GetPath}{wxurigetpath}, respectively.
-\item ConvertToValidURI has been replaced by wxURI. Do not use
+\item ConvertToValidURI has been replaced by \helpref{wxURI}{wxuri}. Do not use
ConvertToValidURI for future applications.
-\item ConvertFromURI has been replaced by wxURI::Unescape.
+\item ConvertFromURI has been replaced by \helpref{wxURI::Unescape}{wxuriunescape}.
\end{itemize}
-\subsubsection{Less drastic incompatable changes since 2.4.x}\label{24incompatiblelessdrastic}
+\subsubsection{Less drastic incompatible changes since 2.4.x}\label{24incompatiblelessdrastic}
-- no initialization/cleanup can be done in wxApp/~wxApp because they are
+- no initialization/cleanup can be done in \helpref{wxApp}{wxappctor}/\helpref{~wxApp}{wxappdtor} because they are
now called much earlier/later than before; please move any exiting code
- from there to wxApp::OnInit()/OnExit()
+ from there to \helpref{wxApp::OnInit()}{wxapponinit}/\helpref{OnExit()}{wxapponexit}
-- also, OnExit() is not called if OnInit() fails
+- also, \helpref{OnExit()}{wxapponexit} is not called if \helpref{OnInit()}{wxapponinit} fails
-- finally the program exit code is OnRun() return value, not OnExit() one
+- finally the program exit code is \helpref{OnRun()}{wxapponrun} return value, not \helpref{OnExit()}{wxapponexit} one
-- wxTheApp can't be assigned to any longer, use wxApp::SetInstance() instead
+- \texttt{wxTheApp} can't be assigned to any longer, use \helpref{wxApp::SetInstance()}{wxappsetinstance} instead
-- wxFileType::GetIcon() returns wxIconLocation, not wxIcon
+- \helpref{wxFileType::GetIcon()}{wxfiletypegeticon} returns \helpref{wxIconLocation}{wxiconlocation}, not \helpref{wxIcon}{wxicon}
-- wxColourDatabase is not a wxList any more, use AddColour to add new colours
+- wxColourDatabase is not a \helpref{wxList}{wxlist} any more, use AddColour to add new colours
- wxWindow::Clear() is now called ClearBackground()
- (most) controls now inherit parents colours by default, override
ShouldInheritColours() to return false if you don't want this to happen
-- wxApp::SendIdleEvent() now takes 2 arguments
+- \helpref{wxApp::SendIdleEvents()}{wxappsendidleevents} now takes 2 arguments
-- wxTabView::GetLayers() changed return type from wxList& to wxTabLayerList&
+- wxTabView::GetLayers() changed return type from \helpref{wxList&}{wxlist} to wxTabLayerList&
(when WXWIN\_COMPATIBILITY\_2\_4 == 0)
- wxID\_SEPARATOR (id used for the menu separators) value changed from -1 to -2
other ports under MSW, new code is actually correct but different from weird
stuff they were doing before so the behaviour of your programs might change
-- wxTaskBarIcon objects must now be destroyed before the application can exit.
+- \helpref{wxTaskBarIcon}{wxtaskbaricon} objects must now be destroyed before the application can exit.
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 compatibility mode,
+- \helpref{wxZlibInputStream}{wxzlibinputstream} is not by default compatible with the output of the
+ 2.4.x version of \helpref{wxZlibOutputStream}{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),
+- when WXWIN\_COMPATIBILITY\_2\_4 == 0 \helpref{wxHashTable}{wxhashtable} uses a new implementation
+ not using \helpref{wxList}{wxlist} keyed interface (the same used when wxUSE\_STL == 1),
the only incompatibility being that Next() returns a wxHashTable::Node*
instead of a wxNode*.
objects returned by these methods so you should simply switch to using const
methods.
-- wxWindow::GetFont() now returns wxFont object instead of reference
+- \helpref{wxWindow::GetFont()}{wxwindowgetfont} now returns \helpref{wxFont}{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.
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
+- \helpref{wxFile}{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
+ return value of \helpref{wxFile::Length()}{wxfilelength}, 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
- [MSW only] wxWindow::GetUseCtl3D(), GetTransparentBackground() and
SetTransparent() as well as wxNO\_3D and wxUSER\_COLOURS styles
-- wxList keyed interface: use wxHashMap instead
+- \helpref{wxList}{wxlist} keyed interface: use \helpref{wxHashMap}{wxhashmap} instead
- wxColourDatabase::FindColour(): use Find() instead (NB: different ret type)
projects / wxWidgets.git / blobdiff