patch from Utensil Candel which refactors and documents the AutoCaptureMechanism...

[wxWidgets.git] / docs / changes.txt

diff --git a/docs/changes.txt b/docs/changes.txt
index f3592e1ec557bd06b92fc54ea633219f5b0df616..db956a1b46c6448ce3998b01bb20510cb04c8443 100644 (file)
--- a/docs/changes.txt
+++ b/docs/changes.txt
@@ -186,9 +186,9 @@ Changes in behaviour which may result in compilation errors
   derives from wxObject; instead of using wxDynamicCast with wxVariantData you
   can use the macro wxDynamicCastVariantData with the same arguments.
 
   derives from wxObject; instead of using wxDynamicCast with wxVariantData you
   can use the macro wxDynamicCastVariantData with the same arguments.
 

-- wxWindow::Next/PrevControlId() don't exist any more as they can't be
+- wxWindow::Next/PrevControlId() don't exist any more as they couldn't be

   implemented correctly any longer because automatically generated ids are not
   implemented correctly any longer because automatically generated ids are not

-  necessarily allocated consecutively any more. Use GetChildren() to find the
+  necessarily allocated consecutively now. Use GetChildren() to find the

   next/previous control sibling instead.
 
 - Calling wxConfig::Write() with an enum value will fail to compile because
   next/previous control sibling instead.
 
 - Calling wxConfig::Write() with an enum value will fail to compile because


@@ -199,6 +199,15 @@ Changes in behaviour which may result in compilation errors
   have been changed to accept "wxBitmapType bitmaptype", please use enum
   wxBitmapType in your code.
 
   have been changed to accept "wxBitmapType bitmaptype", please use enum
   wxBitmapType in your code.
 

+- wxGridCellEditor::EndEdit() signature has changed and it was split in two
+  functions, one still called EndEdit() and ApplyEdit(). See the documentation
+  of the new functions for more details about how grid editors should be
+  written now.
+
+- wxEVT_GRID_CELL_CHANGE event renamed to wxEVT_GRID_CELL_CHANGED and shouldn't
+  be vetoed any more, use the new wxEVT_GRID_CELL_CHANGING event to do it.
+
+

 Deprecated methods and their replacements
 -----------------------------------------
 
 Deprecated methods and their replacements
 -----------------------------------------
 


@@ -223,6 +232,8 @@ Deprecated methods and their replacements
   respectively a wxBrushStyle and a wxPenStyle value instead of a plain "int style";
   use the new wxBrush/wxPen style names (wxBRUSHSTYLE_XXX and wxPENSTYLE_XXX) instead
   of the old deprecated wxXXX styles (which however are still available).
   respectively a wxBrushStyle and a wxPenStyle value instead of a plain "int style";
   use the new wxBrush/wxPen style names (wxBRUSHSTYLE_XXX and wxPENSTYLE_XXX) instead
   of the old deprecated wxXXX styles (which however are still available).

+- EVT_GRID_CELL_CHANGE was deprecated, use EVT_GRID_CELL_CHANGED instead if you
+  don't veto the event in its handler and EVT_GRID_CELL_CHANGING if you do.

 - EVT_CALENDAR_DAY event has been deprecated, use EVT_CALENDAR_SEL_CHANGED.
 - EVT_CALENDAR_MONTH and EVT_CALENDAR_YEAR events are deprecated,
   use EVT_CALENDAR_PAGE_CHANGED which replaces both of them.
 - EVT_CALENDAR_DAY event has been deprecated, use EVT_CALENDAR_SEL_CHANGED.
 - EVT_CALENDAR_MONTH and EVT_CALENDAR_YEAR events are deprecated,
   use EVT_CALENDAR_PAGE_CHANGED which replaces both of them.


@@ -235,6 +246,8 @@ Deprecated methods and their replacements
   it with SetDeviceClippingRegion() if this was the correct thing to do in your
   code.
 - wxTE_AUTO_SCROLL style is deprecated as it's always on by default anyhow.
   it with SetDeviceClippingRegion() if this was the correct thing to do in your
   code.
 - wxTE_AUTO_SCROLL style is deprecated as it's always on by default anyhow.

+- wxThreadHelper::Create() has been deprecated in favour of wxThreadHelper::CreateThread
+  which has a better name for a mix-in class, and allows setting the thread type.

 
 
 Major new features in this release
 
 
 Major new features in this release


@@ -250,12 +263,17 @@ Major new features in this release
 - New propgrid library containing wxPropertyGrid and related classes, many
   enhancements to wxDataViewCtrl.
 
 - New propgrid library containing wxPropertyGrid and related classes, many
   enhancements to wxDataViewCtrl.
 

-- Events loops, timers and sockets can now be used in wxBase, without GUI.
+- Event loops, timers and sockets can now be used in wxBase, without GUI.

 
 

-- Documentation sources for wxWidgets have been converted from LaTex to Doxygen-styled
-  headers; this allowed many improvements on the documentation (screenshots,
-  better linking, function signature checks, etc).
-  Any report about inaccuracies in documentation is welcome.
+- Events can now be connected to any functor, not necessarily a method of
+  wxEvtHandler-derived class. The compile-time safety was also improved.
+
+- Documentation for wxWidgets has been converted from LaTex to C++ headers
+  with Doxygen comments and significantly improved in the process (screenshots
+  of various controls were added, more identifiers are now linked to their
+  definition &c). Any reports about inaccuracies in the documentation are
+  welcome (and due to using the simple Doxygen syntax it is now easier than
+  ever to submit patches correcting them! :-)

 
 
 2.9.0
 
 
 2.9.0


@@ -278,6 +296,7 @@ All:
 - Added wxMemoryInputStream(wxInputStream&) ctor (Stas Sergeev).
 - Implemented wxMemoryInputStream::CanRead().
 - Implemented wxMemoryFSHandler::FindFirst/Next().
 - Added wxMemoryInputStream(wxInputStream&) ctor (Stas Sergeev).
 - Implemented wxMemoryInputStream::CanRead().
 - Implemented wxMemoryFSHandler::FindFirst/Next().

+- Added wxEventLoop::DispatchTimeout().

 - Added wxEXEC_BLOCK flag (Hank Schultz).
 - Add support for wxStream-derived classes to wxRTTI (Stas Sergeev).
 - Added wxStreamBuffer::Truncate() (Stas Sergeev).
 - Added wxEXEC_BLOCK flag (Hank Schultz).
 - Add support for wxStream-derived classes to wxRTTI (Stas Sergeev).
 - Added wxStreamBuffer::Truncate() (Stas Sergeev).


@@ -307,19 +326,21 @@ All:
 - Added wxString::Capitalize() and MakeCapitalized().
 - Added wxArray::swap().
 - Added wxSHUTDOWN_LOGOFF and wxSHUTDOWN_FORCE wxShutdown() flags (troelsk).
 - Added wxString::Capitalize() and MakeCapitalized().
 - Added wxArray::swap().
 - Added wxSHUTDOWN_LOGOFF and wxSHUTDOWN_FORCE wxShutdown() flags (troelsk).

-- Added wxArtProvider::GetNativeSizeHint(); GetSizeHint() as well as
-  GetNativeSizeHint() now return more sensible values in wxMSW and wxMac and
-  no longer return bogus values.
+- Added wxSocket::ShutdownOutput().
+- Handle exceptions thrown from overridden wxView::OnCreate() gracefully.

 
 All (Unix):
 
 - Added wx-config --optional-libs command line option (John Labenski).
 
 All (Unix):
 
 - Added wx-config --optional-libs command line option (John Labenski).

+- Noticeably (by a factor of ~150) improve wxIPC classes performance.

 
 All (GUI):
 
 - Added wxDataViewCtrl class and helper classes.
 - Integrated wxPropertyGrid in wxWidgets itself (Jaakko Salli).
 - Provide native implementation of wxCalendarCtrl under wxMSW and wxGTK.
 
 All (GUI):
 
 - Added wxDataViewCtrl class and helper classes.
 - Integrated wxPropertyGrid in wxWidgets itself (Jaakko Salli).
 - Provide native implementation of wxCalendarCtrl under wxMSW and wxGTK.

+- Added wxHeaderCtrl and allow using it in wxGrid.
+- Added wxRearrangeList, wxRearrangeCtrl and wxRearrangeDialog.

 - Added {wxTextCtrl,wxComboBox}::AutoComplete() and AutoCompleteFileNames().
 - Added wxH[V]ScrolledWindow (Brad Anderson, Bryan Petty).
 - Added wxNotificationMessage class for non-intrusive notifications.
 - Added {wxTextCtrl,wxComboBox}::AutoComplete() and AutoCompleteFileNames().
 - Added wxH[V]ScrolledWindow (Brad Anderson, Bryan Petty).
 - Added wxNotificationMessage class for non-intrusive notifications.


@@ -327,6 +348,7 @@ All (GUI):
 - Added wxWrapSizer (Arne Steinarson).
 - Added wxSpinCtrlDouble (John Labenski).
 - Support custom labels in wxMessageDialog (Gareth Simpson for wxMac version).
 - Added wxWrapSizer (Arne Steinarson).
 - Added wxSpinCtrlDouble (John Labenski).
 - Support custom labels in wxMessageDialog (Gareth Simpson for wxMac version).

+- Added wxScrolledWindow::ShowScrollbars().

 - Also added wxCANCEL_DEFAULT to wxMessageDialog.
 - Allow copying text in the log dialogs.
 - Added multisample (anti-aliasing) support to wxGLCanvas (Olivier Playez).
 - Also added wxCANCEL_DEFAULT to wxMessageDialog.
 - Allow copying text in the log dialogs.
 - Added multisample (anti-aliasing) support to wxGLCanvas (Olivier Playez).


@@ -342,6 +364,7 @@ All (GUI):
 - Added wxWindow::AlwaysShowScrollbars() (Julian Scheid).
 - Added wxMouseEvent::GetClickCount() (Julian Scheid).
 - Added wxBG_STYLE_TRANSPARENT background style (Julian Scheid).
 - Added wxWindow::AlwaysShowScrollbars() (Julian Scheid).
 - Added wxMouseEvent::GetClickCount() (Julian Scheid).
 - Added wxBG_STYLE_TRANSPARENT background style (Julian Scheid).

+- Added support for drop-down toolbar buttons to XRC.

 - Added XRCSIZERITEM() macro for obtaining sizers from XRC (Brian Vanderburg II).
 - New and improved wxFileCtrl (Diaa Sami and Marcin Wojdyr).
 - Added wxEventBlocker class (Francesco Montorsi).
 - Added XRCSIZERITEM() macro for obtaining sizers from XRC (Brian Vanderburg II).
 - New and improved wxFileCtrl (Diaa Sami and Marcin Wojdyr).
 - Added wxEventBlocker class (Francesco Montorsi).


@@ -405,9 +428,15 @@ All (GUI):
 - Added "enabled" and "hidden" attributes to radio box items in XRC.
 - wxWindow::IsBeingDeleted() now returns true not only if the window itself is
   marked for destruction but also if any of its parent windows are.
 - Added "enabled" and "hidden" attributes to radio box items in XRC.
 - wxWindow::IsBeingDeleted() now returns true not only if the window itself is
   marked for destruction but also if any of its parent windows are.

-- Improved drawing of the hint during column move in wxGrid.
+- Improved drawing of the hint during column move in wxGrid (Santo Pfingsten).

 - Add wxGridSelectRowsOrColumns selection mode to wxGrid.
 - Add wxGridSelectRowsOrColumns selection mode to wxGrid.

+- Add wxEVT_GRID_CELL_CHANGING event matching wxEVT_GRID_CELL_CHANGED.

 - Get/HasModifiers() of wxKeyEvent are now also available in wxMouseEvent.
 - Get/HasModifiers() of wxKeyEvent are now also available in wxMouseEvent.

+- Provide new/old cell value in wxEVT_GRID_CELL_CHANGING/CHANGED events.
+- Added wxArtProvider::GetNativeSizeHint(); GetSizeHint() as well as
+  GetNativeSizeHint() now return more sensible values in wxMSW and wxMac and
+  no longer return bogus values.
+- Added wxControl::SetLabelText() and EscapeMnemonics().

 
 wxGTK:
 
 
 wxGTK:
 


@@ -441,6 +470,7 @@ wxMSW:
 - Fixed infinite loop in wxThread::Wait() in console applications.
 - Return the restored window size from GetSize() when window is minimized.
 - wxCheckListBox now looks more native, especially under XP (Marcin Malich).
 - Fixed infinite loop in wxThread::Wait() in console applications.
 - Return the restored window size from GetSize() when window is minimized.
 - wxCheckListBox now looks more native, especially under XP (Marcin Malich).

+- wxCheckListBox now also supports use of client data (Marcin Malich).

 - Allow tooltips longer than 64 (up to 128) characters in wxTaskBarIcon
 - Fix centering wxFileDialog and allow positioning it.
 - Allow centering wxMessageDialog on its parent window (troelsk).
 - Allow tooltips longer than 64 (up to 128) characters in wxTaskBarIcon
 - Fix centering wxFileDialog and allow positioning it.
 - Allow centering wxMessageDialog on its parent window (troelsk).