]> git.saurik.com Git - wxWidgets.git/blame - docs/changes.txt
Add forceTrueColour option to SetBestVisual().
[wxWidgets.git] / docs / changes.txt
CommitLineData
5fae57de
JS
1---------------------------------------------------------------
2wxWidgets Change Log - For more verbose changes, see the manual
3---------------------------------------------------------------
d643b80e 4
aae53500
VZ
5INCOMPATIBLE CHANGES SINCE 2.6.x
6================================
7
b1f3b29c
VZ
8Changes in behaviour not resulting in compilation errors, please read this!
9---------------------------------------------------------------------------
10
11- For all wxInputStreams, Eof() becomes true after an attempt has been made
12 to read _past_ the end of file.
13- wxFileName::DirExists() checks if the path of the file is a directory, not
049e9de7
JS
14 if the whole name is a directory.
15- wxDialog::CreateButtonSizer() may return NULL now, please see the manual.
16- wxStaticBoxSizer now deletes the associated wxStaticBox when it is deleted.
7788fc40 17- wxArray::Alloc() now works as reserve() and does not clear the array any more
b1f3b29c 18- Windows calling CaptureMouse() are now required to handle the
049e9de7 19 wxEVT_MOUSE_CAPTURE_LOST event and not call ReleaseMouse() in this case.
a02dd570
MW
20- wxInputStream::GetC() now returns an int in the range 0 - 255 on success
21 instead of a char the range -128 - 127.
22- A sequence returned by wxFileSystem::FindFirst()/FindNext() may now be
23 be scoped to a single instance of wxFileSystem.
b1f3b29c
VZ
24
25
26Changes in behaviour which may result in compilation errors
27-----------------------------------------------------------
28
d2a93a2a
VZ
29- Some classes (notably wxBitmap and wxImage) don't define operator==() as it
30 used to work in somewhat unexpected way as it compared only internal pointers
31 and not the object data. The code using it will have to be updated:
32 * If the object was compared with wxNullXXX, use IsOk() method instead
c751d1d7 33 * If valid object need to be compared, use IsSameAs() to reproduce the old
bc2ce7a5 34 behaviour or change the code to avoid comparing bitmaps &c.
7f0d9d71 35- wxFontData::GetColour() now returns a const colour.
e72d82bb 36- wxDC objects can't be created directly now (this never worked, now it doesn't
7f0d9d71 37 even compile).
7f0d9d71 38- wxCHECK family of macros now must be followed by a semicolon.
eec47cc6
VZ
39- wxMBConv::cMB2WC() and cWC2MB() take size of the input buffer and return
40 length of the converted string in all cases now.
bc55e31b
VS
41- wxHtmlWindow::OnCellClicked() now returns bool.
42- wxHtmlCell::OnMouseClick() was deprecated and replaced with
43 wxHtmlCell::ProcessMouseClick(); old code overriding OnMouseClick() will
44 continue to work with WXWIN_COMPATIBILITY_2_6, but should be rewritten to
45 use ProcessMouseClick().
88a1b648
VS
46- wxHtmlCell::GetCursor() was deprecated and replaced with
47 wxHtmlCell::GetMouseCursor(); old code overriding GetCursor() will
48 continue to work with WXWIN_COMPATIBILITY_2_6, but should be rewritten to
49 use GetMouseCursor().
fd0bab43 50- wxHtmlCell::AdjustPagebreak() signature has changed, update your code if you
7f0d9d71 51 override it.
6540132f 52- wxFontEnumerator::GetFacenames() and GetEncodings() now return arrays and
7f0d9d71 53 not pointers to arrays.
4334c3d5 54- SetDefaultItem() method was moved from wxPanel to wxTopLevelWindow
684e5b95 55- wxDialog::OnOK/OnCancel() don't exist any more, use SetAffirmative/EscapeId()
4f92e6ef 56- wxPathList doesn't derive from (deprecated) wxStringList any more
5d5d9ae8 57- wxGLContext class has no 1:1 coupling to a wxGLCanvas class any more.
049e9de7
JS
58 As a consequence, the class interface changed largely. Code updates, if
59 any are required at all, are easy to accomplish though.
eec47cc6 60
637b7e4f 61
f303d69f
VZ
62Deprecated methods since 2.6.x and their replacements
63-----------------------------------------------------
64
7f0d9d71 65- wxGetWorkingDirectory() deprecated in favour of wxGetCwd().
049e9de7 66- wxDC::BeginDrawing() and wxDC::EndDrawing() deprecated, don't use them.
bc2ce7a5
JS
67- wxWindowBase::GetBestFittingSize --> wxWindowBase::GetEffectiveMinSize.
68- wxWindowBase::SetBestFittingSize --> wxWindowBase::SetInitialSize.
f303d69f 69
aae53500 70
9129836e 71Major new features in 2.8 release
b1f3b29c 72---------------------------------
12dc0a01 73
049e9de7 74- New AUI library supporting docking windows and much more.
bc2ce7a5
JS
75- New rich text control library implementing a generic wxRichTextCtrl,
76 using only the wxWidgets API. Also includes formatting dialogs, conversion
77 to HTML, and printing classes.
78- New wxComboCtrl class giving the ability to create custom, graphical
79 comboboxes. Associated classes include wxOwnerDrawnComboBox, wxComboPopup
80 and wxBitmapComboBox.
81- Further functionality including wxAnimationCtrl (moved from contrib/src/anim
82 and enhanced), wxHtmlSimpleListBox, wxHyperlinkCtrl, wxColourPickerCtrl,
83 wxDirPickerCtrl, wxFilePickerCtrl, wxFontPickerCtrl, wxCollapsiblePane,
84 wxAboutBox, wxTreebook, tar streams.
12dc0a01
VZ
85
86
9129836e
VZ
872.8.0
88-----
89
90All:
91
92- wxArrayString::Alloc() now works as reserve() and doesn't clear array contents
bc2ce7a5 93- Fixed long standing bug in wxFileConfig groups renaming (Antti Koivisto).
9129836e 94
077c7880
VZ
95wxMSW:
96
bc2ce7a5 97- Fixed version script problems when using configure with cygwin/mingw32.
d5eaa19f 98- Use system default paper size for printing instead of A4
077c7880 99
432efcb0
RD
1002.7.2
101-----
102
f8f6c91a
MW
103All:
104
105- Added wxFFile overload to wxFileName::CreateTemporaryFileName().
049e9de7 106- Added GetTempDir() to wxFileName and wxStandardPaths.
f068697b
MW
107- Added wxTar streams.
108- Added wxFilterFSHandler and wxArchiveFSHandler.
bc2ce7a5 109- Added wxString::ToLongLong() and ToULongLong().
f8f6c91a 110
432efcb0
RD
111All (GUI):
112
113- wxMemoryDC constructor now optionally accepts a wxBitmap parameter,
114 calling SelectObject itself if a valid bitmap is passed.
19c9f36f
RD
115- Reverted wxBuffered[Paint]DC to pre 2.7.1 state, added
116 wxAutoBufferedPaintDC and wxAutoBufferedPaintDCFactory.
049e9de7
JS
117- Renamed wxProgressDialog::UpdatePulse() to just Pulse().
118- Added wxCollapsiblePane (Francesco Montorsi).
119- Added wxSimpleHtmlListBox (Francesco Montorsi).
96202eaa
JS
120- Printing framework fixes by Robert J. Lang. Bugs fixed,
121 wxPrinterDC::GetPaperRect() and other functions added to allow
122 easier printing implementation, and the documentation updated.
123- Many enhancements to wxRichTextCtrl including URL support,
124 formatting and symbol dialogs, print/preview, and better list
125 formatting.
bc2ce7a5
JS
126- Support for loading TGA files added (Seth Jackson).
127- Added wxTB_RIGHT style for right-aligned toolbars (Igor Korot).
0f11c233 128- wxHtmlWindow now generates events on link clicks (Francesco Montorsi).
bc2ce7a5 129- wxHtmlWindow now also generates wxEVT_COMMAND_TEXT_COPY event.
432efcb0 130
2baa2b0e
VZ
131Unix Ports:
132
133- Added autopackage for wxGTK and an example of using autopackage for a wx
049e9de7
JS
134 program (Francesco Montorsi).
135
136wxGTK:
2baa2b0e 137
4ff4d045 138- More RTL work.
049e9de7
JS
139- Support wxALWAYS_SHOW_SB.
140- Speed up MIME types loading. Only the GNOME database should be loaded under
141 GNOME etc. For this, the code queries the X11 session protocol.
96202eaa 142- wxCaret redraw problem during scrolling fixed.
432efcb0
RD
143
144
e63f19ba
VZ
1452.7.1
146-----
147
d1af8e2d
VZ
148All:
149
3306aec1
JS
150- Added wxDir::FindFirst() (Francesco Montorsi).
151- Added wxPlatformInfo class (Francesco Montorsi).
152- Added wxLocale::IsAvailable() (Creighton).
bc2ce7a5
JS
153- Added Malay translations (Mahrazi Mohd Kamal).
154- Added reference counting for wxVariant.
b7cacb43 155- For consistency, all classes having Ok() method now also have IsOk() one, use
049e9de7
JS
156 of the latter form is preferred although the former hasn't been deprecated yet.
157- Added wxFileName::Is(Dir|File)(Writ|Read|Execut)able() (Francesco Montorsi).
158- Added wxFileName::GetSize() and GetHumanReadableSize() (Francesco Montorsi).
159- Added wxSizer::Replace (Francesco Montorsi).
160- wxXmlDocument can now optionally preserve whitespace (Francesco Montorsi).
78041f2e
VZ
161- Added wxBookCtrl::ChangeSelection() and wxTextCtrl::ChangeValue() to provide
162 event-free alternatives to SetSelection() and SetValue() functions; see the
163 "Events generated by the user vs programmatically generated events" paragraph
049e9de7 164 in the "Event handling overview" topic for more info.
d1af8e2d 165
e63f19ba
VZ
166All (GUI):
167
3306aec1
JS
168- Support for right-to-left text layout (started by Diaa Sami during Google Summer of
169 Code, with a lot of help from Tim Kosse and others).
049e9de7
JS
170- wxAnimationCtrl added (Francesco Montorsi).
171- Added wxAboutBox() function for displaying the standard about dialog.
3306aec1
JS
172- Added wxID_PAGE_SETUP standard id.
173- Added wxSize::IncBy() and DecBy() methods.
049e9de7 174- Added wxTextCtrl::IsEmpty().
3306aec1
JS
175- Added file type parameter to wxTextCtrl::LoadFile, wxTextCtrl::SaveFile for
176 consistency with wxRichTextCtrl.
177- wxRichTextCtrl: fixed range out-by-one bug to be consistent with wxTextCtrl API,
178 fixed some attribute bugs and added wxRichTextStyleComboCtrl.
049e9de7
JS
179- Added wxWindow::IsDoubleBuffered().
180- Added wxHL_ALIGN_* flags to wxHyperlinkCtrl (Francesco Montorsi).
181- Added wxGauge::Pulse() and wxProgressDialog::UpdatePulse() (Francesco Montorsi).
e63f19ba 182
916eecaa
VZ
183wxMSW:
184
3306aec1 185- Implemented wxComboBox::SetEditable().
a0020fcd 186- wxSemaphore::Post() returns wxSEMA_OVERFLOW as documented (Christian Walther)
3306aec1
JS
187- Fixed a bug whereby static controls didn't use the correct text colour if the
188 parent's background colour had been set (most noticeable when switching to a
189 high-contrast theme).
049e9de7 190- Respect wxBU_EXACTFIT style in wxToggleButton (Alexander Borovsky).
916eecaa 191
95768535
MW
192wxMac:
193
194- Add parameter to the --enable-universal_binary configure option for the path
195 to the SDK.
196
ab73fe8d
VZ
197wxGTK:
198
3306aec1
JS
199- Automatically use stock items for menu items with standard ids.
200- Setting cursor now works for all controls.
049e9de7 201- Implemented right-to-left support.
ae6a64b6 202- Implemented left indentation and tab stops support in wxTextCtrl (Tim Kosse).
049e9de7 203- Fixed wxHTML rendering of underlined text of multiple words (Mart Raudsepp).
ab73fe8d 204
b48f51ca
VZ
205wxUniv:
206
049e9de7 207- Added wxTLW::UseNativeDecorations() and UseNativeDecorationsByDefault().
b48f51ca 208
e63f19ba 209
254e8e29
VZ
2102.7.0
211-----
212
42d0df00
VZ
213All:
214
7f0d9d71
JS
215- Added positional parameters support to wxVsnprintf() (Francesco Montorsi).
216- wx(F)File, wxTextFile and wxInputStreams recognize Unicode BOM now.
217- Many fixes for UTF-16/32 handling in Unicode builds.
b83d533a 218- wxLaunchDefaultBrowser() now supports wxBROWSER_NEW_WINDOW flag.
3af9f2de 219- Added wxStandardPaths::GetResourcesDir() and GetLocalizedResourcesDir()
7f0d9d71 220- Added wxStandardPaths::GetDocumentsDir() (Ken Thomases).
b83d533a 221- Added wxStringTokenizer::GetLastDelimiter(); improved documentation.
7f0d9d71
JS
222- Fixed wxTextFile in Unicode build.
223- Added possibility to specify dependencies for a wxModule.
c6bb9255
MW
224- Speed improvements to wxRegEx when matching is done in a loop such as
225 during a search and replace.
226- Fix regerror and regfree name conficts when built-in regex and system regex
227 are both used in the same program.
a5fa20cb
JS
228- Basic authentication supported added to wxHTTP.
229- wxCondition::WaitTimeout() now returns correct value when timeout occurs.
230- Fixed occasional wxThread cleanup crash.
231- Bug in wxLogStream::DoLogString in Unicode builds fixed.
232- Added support for memo fields to wxODBC.
233- Fixed Unicode builds using SunPro compiler by defining__WCHAR_TYPE__.
234- wxFileName now also looks for TMPDIR on Unix.
235- Fixed build error in list.h with VC++ 2005.
236- Fixed wxODBC buffer overflow problem in Unicode builds.
2decc3bd 237- Fixed wxSocketBase::InterruptWait on wxBase.
b83d533a
JS
238- Important code cleanup (Paul Cornett).
239- Added support for wxLongLong in wx stream classes (Mark Junker).
24f4fc23 240- wxSOCKET_REUSEADDR can be used with wxSocketClient.
480abc8f 241- Overloaded Connect() and SetLocal() methods for binding to local address/port.
7f0d9d71
JS
242- Albanian translation added (Besnik Bleta).
243- Assert messages now show the function in which assert failed.
244- wxApp::OnAssertFailure() should now be used instead the old wxApp::OnAssert().
245- Fixed several bugs in wxDateTime::ParseDate().
968f291b 246- The WXK*PRIOR and WXK*NEXT constants are now aliases for WXK*PAGEUP
6fa9383b 247 and WXK*PAGEDOWN. If you have switch statements that use both
968f291b 248 constants from a set then you need to remove the PRIOR/NEXT
6fa9383b 249 versions in order to eliminate compiler errors.
44c930eb
JG
250- Fixed bug where wxDateTime::Now() would sometimes return an incorrect value
251 the first time it was called.
7f0d9d71
JS
252- Added wxString::rbegin() and rend().
253- Added wxString::EndsWith().
635f2bad
KH
254- wxSocket::_Read continues reading from socket after exhausting pushback buffer.
255 Previously, only the buffer would be returned, even if more data was requested.
7f0d9d71
JS
256- Added wxPowerEvent (currently MSW-only).
257- Make wx-config compatible with Bourne shells.
3306aec1
JS
258- Fixed wxDb::Open(wxDbConnectInf) when using connection string (Hellwolf Misty).
259- Fixed crash in wxDb::Open() in Unicode build (Massimiliano Marretta).
260- Fixed wxTimeSpan::Format() for negative time spans.
261- Optionally count repeating wxLog messages instead of logging all (Lauri Nurmi).
42d0df00 262
c6ece595
VZ
263All (GUI):
264
3306aec1 265- New AUI (Advanced User Interface) library for docking windows and much more.
7f0d9d71 266- Added wxComboCtrl and wxOwnerDrawnComboBox (Jaakko Salli).
03a37db9 267- Added wxTreebook (uses a wxTreeCtrl to control pages).
7f0d9d71
JS
268- Added wxColour/Dir/File/Font/PickerCtrls (Francesco Montorsi).
269- Added wxDC::GradientFillLinear/Concentric().
270- Added wxHyperlinkCtrl (Francesco Montorsi).
271- Added clipboard events (wxEVT_COMMAND_TEXT_COPY/CUT/PASTE).
272- Allow to reorder wxGrid columns by drag-and-drop (Santiago Palacios).
273- Added wxRadioBox::SetItemToolTip().
274- Added support for CMYK JPEG images loading (Robert Wruck).
275- Added wxListCtrl::GetSubItemRect() and subitem hit testing (Agron Selimaj).
276- Added wxKeyEvent::GetModifiers().
5d7836c4 277- Added wxDialog::SetEscapeId().
f7c40316 278- wxItemContainerImmutable::FindString unified (affects wxRadioBox, wxListBox,
5d7836c4
JS
279 wxComboBox and wxChoice).
280- wxWindow::Fit() now works correctly for frames and dialogs too.
281- Added access to the border size between pages and controller in book
282 based controls (wxBookCtrlBase::Get/SetInternalBorder).
283- Added initial wxRichTextCtrl implementation.
d8fd7acb
WS
284- All book based controls (notebook, treebook etc.) share now the same
285 options for orientation (wxBK_TOP, wxBK_DEFAULT, ...) instead of duplicated
286 wxLB_TOP, wxNB_TOP, wxCHB_TOP, wxTBK_TOP.
3db52265
JS
287- Added parent window parameter to wxHelpController constructor
288 and added SetParentWindow/GetParentWindow.
60104cba 289- wxMultiChoiceDialog uses now wxCheckListBox if possible, wxListBox if not.
b83d533a 290- Added wxBitmapButton::SetHoverBitmap().
60fef964
WS
291- Access to titles through Get/SetTitle is available now only for top level
292 windows (wxDialog, wxFrame).
b83d533a 293- Fixed memory leak of pending events in wxEvtHandler.
7f0d9d71 294- Added wxRadioBox::IsItemEnabled/Shown().
3d941982 295- Added space after list item number in wxHTML.
3c115835 296- Implemented <sub> and <sup> handling in wxHTML (based on patch
b83d533a 297 by Sandro Sigala).
f14d6dd1 298- Added caption parameter to wxGetFontFromUser and wxGetColourFromUser.
7dd40b6f 299- Added wxGetMouseState function.
c3e5d4e2
JS
300- Added wxHtmlHelpWindow, wxHtmlHelpDialog and wxHtmlModalHelp classes,
301 allowing HTML help to be embedded in an application.
a5fa20cb
JS
302- wxCalendarCtrl positioning and hit-testing fixes for dimensions other than
303 best size.
d9170b47 304- wxCalendarCtrl colour schema changed and adjusted to system settings.
7f0d9d71 305- wxImage::Mirror() and GetSubBitmap() now support alpha (Mickey Rose).
a5fa20cb
JS
306- More checking of image validity before loading into wxImage.
307- Added wxImage::ConvertToGreyscale.
308- Added ability to use templates with static event tables
b83d533a
JS
309 with BEGIN_EVENT_TABLE_TEMPLATEn() macros.
310- Added play, pause, and state change events to wxMediaCtrl.
a5fa20cb 311- Added double-buffering to wxVListBox and fixed a scrolling issue.
fd0d619f 312- Added wxToolbook (uses a wxToolBar to control pages).
cc8bc5aa
JS
313- Added SetSheetStyle to wxPropertySheetDialog and allowed it to
314 behave like a Mac OS X settings dialog.
7cc1ad29
JS
315- Added <disabled> XRC tag for wxToolBar elements and <bg> for wxToolBar itself.
316- Fixed centering of top level windows on secondary displays.
317- Implemented wxDisplay::GetFromWindow() for platforms other than MSW.
b83d533a 318- UpdateUI handler can now show/hide the window too (Ronald Weiss).
0f30d8e3 319- More than one filter allowed in in wxDocTemplate filter.
b83d533a
JS
320- Added wxListBox::HitTest().
321- Added wxDisplay::GetClientArea().
894b93d3 322- Indices and counts in wxControlWithItems derived API are unsigned.
bc55e31b
VS
323- Added support for links to wxHtmlListBox; use code has to override
324 wxHtmlListBox::OnLinkClicked() to take advantage of it.
7f0d9d71 325- Added an easier to use wxMenu::AppendSubMenu().
40989e46 326- wxString <-> wxColour conversions in wxColour class (Francesco Montorsi).
7f0d9d71
JS
327- Fixed bug with ignoring blank lines in multiline wxGrid cell labels.
328- Added wxTextAttr::Merge() (Marcin Simonides).
329- Added wxTB_NO_TOOLTIPS style (Igor Korot).
330- Added wxGenericDirCtrl::CollapsePath() (Christian Buhtz).
70934138 331- Added wxTreeCtrl::ExpandAllChildren() (Christian Buhtz)
6b8f5d30 332- Fixed 64-bit issue in wxNotebook causing segfaults on Tru64 Unix.
7f0d9d71
JS
333- Made it possible to associate context help to a region of a window.
334- Added support for tabs in wxRichTextCtrl (Ashish More).
d8766675 335- Fixed problem with zoom setting in print preview.
3b2cb431 336- Moved wxRichTextCtrl from the advanced library to its own.
9804d540 337- wxNB_HITTEST_* flags renamed to wxBK_HITTEST_* to serve all book controls.
07880314 338- Added wxTopLevelWindow::SetTransparent and CanSetTransparent, with
50f3c41d 339 implementations (so far) for wxMSW and wxMac.
3306aec1
JS
340