-\subsubsection{Less drastic incompatable changes since 2.4.x}\label{24incompatiblelessdrastic}
-
-- no initialization/cleanup can be done in wxApp/~wxApp because they are
- now called much earlier/later than before; please move any exiting code
- from there to wxApp::OnInit()/OnExit()
-
-- also, OnExit() is not called if OnInit() fails
-
-- finally the program exit code is OnRun() return value, not OnExit() one
-
-- wxTheApp can't be assigned to any longer, use wxApp::SetInstance() instead
-
-- wxFileType::GetIcon() returns wxIconLocation, not wxIcon
-
-- wxColourDatabase is not a wxList any more, use AddColour to add new colours
-
-- wxWindow::Clear() is now called ClearBackground()
-
-- pointer returned by wxFont::GetNativeFontInfo() must not be deleted now
-
-- wxMouseEvent::Moving() doesn't return true if mouse is being dragged any more
-
-- (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
-
-- wxTabView::GetLayers() changed return type from wxList& to wxTabLayerList&
- (when WXWIN\_COMPATIBILITY\_2\_4 == 0)
-
-- wxID\_SEPARATOR (id used for the menu separators) value changed from -1 to -2
-
-- wxGetNumberFromUser() is now in separate wx/numdlg.h, not wx/textdlg.h
-
-- wxChoice and wxCombobox now handle their size in the same way as in all the
- 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.
- 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,
- 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),
- the only incompatibility being that Next() returns a wxHashTable::Node*
- instead of a wxNode*.
-
-- non-const wxDC methods GetBackground(), GetBrush(), GetFont() and GetPen()
- as well as wxWindow methods GetFont() and GetCursor() don't exist any more,
- 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 -- 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
-
-- wxSizer::Add/Insert returns pointer to wxSizerItem just added so conditions
- writeen with if(Add(..)==true) will not work. Use if(Add(..)) instead.
-
-- New wxBrush::IsHatch() checking for brush type replaces IS_HATCH macro.
-
-
-
-\subsection{Depreciated changes since 2.4.x}\label{depreciatedsince24}
-
-- wxURL::GetInputStream() and similar functionality has been depreciated in
- favor of other ways of connecting, such as though sockets or wxFileSystem.
-
-- wxDocManager::GetNoHistoryFiles() renamed to GetHistoryFilesCount()
-
-- wxSizer::Remove(wxWindow *), use Detach() instead [it is more clear]
-
-- wxSizer::Set/GetOption(): use Set/GetProportion() instead
-
-- wxKeyEvent::KeyCode(): use GetKeyCode instead
-
-- wxList::Number, First, Last, Nth: use GetCount, GetFirst/Last, Item instead
-
-- wxNode::Next, Previous, Data: use GetNext, GetPrevious, GetData instead
-
-- wxListBase::operator wxList&(): use typesafe lists instead
-
-- wxTheFontMapper: use wxFontMapper::Get() instead
-
-- wxStringHashTable: use wxHashMap instead
-
-- wxHashTableLong: use wxHashMap instead
-
-- wxArrayString::GetStringArray: use wxCArrayString or alternative wxWidgets
- methods taking wxArrayString
-
-- wxArrayString::Remove(index, count): use RemoveAt instead
-
-- wxTreeItemId conversion to long is deprecated and shouldn't be used
-
-- wxTreeCtrl::GetFirst/NextChild() 2nd argument now has type wxTreeItemIdValue
- and not long, please change declarations of "cookie"s in your code
- accordingly -- otherwise your code won't work on 64 bit platforms
-
-- [MSW only] wxWindow::GetUseCtl3D(), GetTransparentBackground() and
- SetTransparent() as well as wxNO\_3D and wxUSER\_COLOURS styles
-
-- wxList keyed interface: use wxHashMap instead
-
-- wxColourDatabase::FindColour(): use Find() instead (NB: different ret type)
-
-- wxHashTable::Next: use wxHashTable::Node* or
- wxHashTable::compatibility\_iterator to store the return
- value
-
-- wxWave class; use wxSound instead
-
-- The wxHIDE\_READONLY flag for wxFileDialog was not implemented
- and has now been removed
+\begin{itemize}\itemsep=0pt
+\item no initialization/cleanup can be done in wxApp's constructor or destructor because they are now called much earlier/later than before; please move any exiting code from there to \helpref{wxApp::OnInit()}{wxapponinit}/\helpref{OnExit()}{wxapponexit}
+\item also, \helpref{OnExit()}{wxapponexit} is not called if \helpref{OnInit()}{wxapponinit} fails
+\item finally the program exit code is \helpref{OnRun()}{wxapponrun} return value, not \helpref{OnExit()}{wxapponexit} one
+\item \texttt{wxTheApp} can't be assigned to any longer, use \helpref{wxApp::SetInstance()}{wxappsetinstance} instead
+\item \helpref{wxFileType::GetIcon()}{wxfiletypegeticon} returns \helpref{wxIconLocation}{wxiconlocation}, not \helpref{wxIcon}{wxicon}
+\item wxColourDatabase is not a \helpref{wxList}{wxlist} any more, use AddColour to add new colours
+\item wxWindow::Clear() is now called ClearBackground()
+\item pointer returned by wxFont::GetNativeFontInfo() must not be deleted now
+\item wxMouseEvent::Moving() doesn't return true if mouse is being dragged any more
+\item (most) controls now inherit parents colours by default, override ShouldInheritColours() to return false if you don't want this to happen
+\item \helpref{wxApp::SendIdleEvents()}{wxappsendidleevents} now takes 2 arguments
+\item wxTabView::GetLayers() changed return type from \helpref{wxList\&}{wxlist} to wxTabLayerList\& (when WXWIN\_COMPATIBILITY\_2\_4 == 0)
+\item wxID\_SEPARATOR (id used for the menu separators) value changed from -1 to -2
+\item wxGetNumberFromUser() is now in separate wx/numdlg.h, not wx/textdlg.h
+\item wxChoice and wxCombobox now handle their size in the same way as in all the 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
+\item \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.
+\item \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.
+\item 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*.
+\item non-const wxDC methods GetBackground(), GetBrush(), GetFont() and GetPen() as well as wxWindow methods GetFont() and GetCursor() don't exist any more, 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.
+\item \helpref{wxWindow::GetFont()}{wxwindowgetfont} now returns \helpref{wxFont}{wxfont} object instead of reference
+\item EVT\_XXX macros are now type-safe; code that uses wrong type for event handler's argument will no longer compile.
+\item Identical functionality of wxFileDialog::ParseWildcard, wxGenericDirCtrl::ParseFilter, Motif and MSW parsing native dialogs is now accessible in ::wxParseCommonDialogsFilter
+\item 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.
+\item \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 \helpref{wxFile::Length()}{wxfilelength}, for example, shouldn't be assigned to off\_t variable any more (the compiler might warn you about this)
+\item wxListItem::m\_data is now of type wxUIntPtr, not long, for compatibility with 64 bit systems
+\item wxSizer::Add/Insert returns pointer to wxSizerItem just added so conditions writeen with if(Add(..)==true) will not work. Use if(Add(..)) instead.
+\item New \helpref{wxBrush::IsHatch()}{wxbrushishatch} checking for brush type replaces IS\_HATCH macro.
+\item wxSystemSettings::GetSystem*() members deprecated and replaced with wxSystemSettings::Get*().
+\end{itemize}
projects / wxWidgets.git / blobdiff