]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/changes.txt
Build the new docs as part of the automated build
[wxWidgets.git] / docs / changes.txt
... / ...
Content-type: text/html ]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/changes.txt


500 - Internal Server Error

Malformed UTF-8 character (fatal) at /usr/lib/x86_64-linux-gnu/perl5/5.40/HTML/Entities.pm line 485, <$fd> line 344.
CommitLineData
1------------------------
2wxWidgets 2.5 Change Log
3------------------------
4
5INCOMPATIBLE CHANGES SINCE 2.4.x
6================================
7
8 Please take a few minutes to read the following list, especially
9 paying attention to the most important changes which are marked
10 with '!' in the first column.
11
12 Also please note that you should ensure that WXWIN_COMPATIBILITY_2_4
13 is defined to 1 if you wish to retain maximal compatibility with 2.4
14 series.
15
16! windows are no longer fully repainted when resized, use new style
17 wxFULL_REPAINT_ON_RESIZE to force this (wxNO_FULL_REPAINT_ON_RESIZE still
18 exists but doesn't do anything any more, this behaviour is default now)
19
20! wxWindow::m_font and m_backgroundColour/m_foregroundColour are no longer
21 always set, use GetFont(), GetBack/ForegroundColour() to access
22 them, and they will be dynamically determined if necessary.
23
24
25! The Sizers have had some fundamental internal changes in the 2.5.2
26 and 2.5.3 releases intended to make them do more of the "Right
27 Thing" but also be as backwards compatible as possible. First a bit
28 about how things used to work:
29
30 * The size that a window had when Add()ed to the sizer was assumed
31 to be its minimal size, and that size would always be used by
32 default when calculating layout size and positions, and the
33 sizer itself would keep track of that minimal size.
34
35 * If the window item was Add()ed with the wxADJUST_MINSIZE flag
36 then when layout was calculated the item's GetBestSize would be
37 used to reset the minimal size that the sizer used.
38
39 The main thrust of the new Sizer changes was to make behaviour like
40 wxADJUST_MINSIZE be the default, and also to push the tracking of
41 the minimal size to the window itself (since it knows its own needs)
42 instead of having the sizer take care of it. Consequently these
43 changes were made:
44
45 * The wxFIXED_MINSIZE flag was added to allow for the old
46 behaviour. When this flag is used the size a window has when
47 Add()ed to the sizer will be treated as its minimal size and it
48 will not be readjusted on each layout.
49
50 * The min size stored in wxWindow and settable with SetSizeHints or
51 SetMinSize will by default be used by the sizer (if it was set)
52 as the minimal size of the sizer item. If the minsize was not
53 set (or was only partially set) then the window's best size is
54 fetched and it is used instead of (or blended with) the minsize.
55 wxWindow:GetBestFittingSize was added to facilitate getting the
56 size to be used by the sizers.
57
58 * The best size of a window is cached so it doesn't need to
59 recaculated on every layout. wxWindow::InvalidateBestSize was
60 added and should be called (usually just internally in control
61 methods) whenever something is done that would make the best
62 size change.
63
64 * All wxControls were changed to set the minsize to what is passed
65 to the constructor or Create method, and also to set the real
66 size of the control to the blending of the minsize and bestsize.
67 wxWindow::SetBestFittingSize was added to help with this,
68 although most controls don't need to call it directly because it
69 is called indirectly via the SetInitialSize called in the base
70 classes.
71
72 At this time, the only situation known not to work the same as
73 before is the following:
74
75 win = new SomeWidget(parent);
76 win->SetSize(SomeNonDefaultSize);
77 sizer->Add(win);
78
79 In this case the old code would have used the new size as the
80 minimum, but now the sizer will use the default size as the minimum
81 rather than the size set later. It is an easy fix though, just move
82 the specification of the size to the constructor (assuming that
83 SomeWidget will set its minsize there like the rest of the controls
84 do) or call SetMinSize instead of SetSize.
85
86 In order to fit well with this new scheme of things, all wxControls
87 or custom controls should do the following things. (Depending on
88 how they are used you may also want to do the same thing for
89 non-control custom windows.)
90
91 * Either override or inherit a meaningful DoGetBestSize method
92 that calculates whatever size is "best" for the control. Once
93 that size is calculated then there should normally be a call to
94 CacheBestSize to save it for later use, unless for some reason
95 you want the best size to be recalculated on every layout.
96
97 * Any method that changes the attributes of the control such that
98 the best size will change should call InvalidateBestSize so it
99 will be recalculated the next time it is needed.
100
101 * The control's constructor and/or Create method should ensure
102 that the minsize is set to the size passed in, and that the
103 control is sized to a blending of the min size and best size.
104 This can be done by calling SetBestFittingSize.
105
106
107
108- no initialization/cleanup can be done in wxApp/~wxApp because they are
109 now called much earlier/later than before; please move any exiting code
110 from there to wxApp::OnInit()/OnExit()
111- also, OnExit() is not called if OnInit() fails
112- finally the program exit code is OnRun() return value, not OnExit() one
113- wxTheApp can't be assigned to any longer, use wxApp::SetInstance() instead
114- wxFileType::GetIcon() returns wxIconLocation, not wxIcon
115- wxColourDatabase is not a wxList any more, use AddColour to add new colours
116- wxWindow::Clear() is now called ClearBackground()
117- pointer returned by wxFont::GetNativeFontInfo() must not be deleted now
118- wxMouseEvent::Moving() doesn't return true if mouse is being dragged any more
119- (most) controls now inherit parents colours by default, override
120 ShouldInheritColours() to return false if you don't want this to happen
121- wxApp::SendIdleEvent() now takes 2 arguments
122- wxTabView::GetLayers() changed return type from wxList& to wxTabLayerList&
123 (when WXWIN_COMPATIBILITY_2_4 == 0)
124- wxID_SEPARATOR (id used for the menu separators) value changed from -1 to -2
125- wxGetNumberFromUser() is now in separate wx/numdlg.h, not wx/textdlg.h
126- wxChoice and wxCombobox now handle their size in the same way as in all the
127 other ports under MSW, new code is actually correct but different from weird
128 stuff they were doing before so the behaviour of your programs might change
129- wxTaskBarIcon objects must now be destroyed before the application can exit.
130 Previously, the application terminated if there were no top level windows;
131 now it terminates if there are no top level windows or taskbar icons left.
132- wxZlibInputStream is not by default compatible with the output of the
133 2.4.x version of wxZlibOutputStream. However, there is a compatibilty mode,
134 switched on by passing wxZLIB_24COMPATIBLE to the constructor.
135- when WXWIN_COMPATIBILITY_2_4 == 0 wxHashTable uses a new implementation
136 not using wxList keyed interface (the same used when wxUSE_STL == 1),
137 the only incompatibility being that Next() returns a wxHashTable::Node*
138 instead of a wxNode*.
139- non-const wxDC methods GetBackground(), GetBrush(), GetFont() and GetPen()
140 as well as wxWindow methods GetFont() and GetCursor() don't exist any more,
141 please fix your code -- it never worked correctly anyhow if you modified the
142 objects returned by these methods so you should simply switch to using const
143 methods.
144- wxWindow::GetFont() now returns wxFont object instead of reference
145- EVT_XXX macros are now type-safe; code that uses wrong type for event
146 handler's argument will no longer compile.
147- Identical functionality of wxFileDialog::ParseWildcard,
148 wxGenericDirCtrl::ParseFilter, Motif and MSW parsing native dialogs
149 is now accessible in ::wxParseCommonDialogsFilter
150- wxNotebookSizer and wxBookCtrlSizer are now deprecated -- the are no longer
151 needed, you can treat wxNotebook as any other control and put it directly
152 into the sizer that was wxNotebookSizer's parent sizer in old code.
153
154
155
156DEPRECATED METHODS SINCE 2.4.x
157==============================
158
159Deprecated methods may still be used but will disappear in future wxWidgets
160versions, please update your code to not use them.
161
162- wxDocManager::GetNoHistoryFiles() renamed to GetHistoryFilesCount()
163- wxSizer::Remove(wxWindow *), use Detach() instead [it is more clear]
164- wxSizer::Set/GetOption(): use Set/GetProportion() instead
165- wxKeyEvent::KeyCode(): use GetKeyCode instead
166- wxList::Number, First, Last, Nth: use GetCount, GetFirst/Last, Item instead
167- wxNode::Next, Previous, Data: use GetNext, GetPrevious, GetData instead
168- wxListBase::operator wxList&(): use typesafe lists instead
169- wxTheFontMapper: use wxFontMapper::Get() instead
170- wxStringHashTable: use wxHashMap instead
171- wxHashTableLong: use wxHashMap instead
172- wxArrayString::GetStringArray: use wxCArrayString or alternative wxWidgets
173 methods taking wxArrayString
174- wxArrayString::Remove(index, count): use RemoveAt instead
175- wxTreeItemId conversion to long is deprecated and shouldn't be used
176- wxTreeCtrl::GetFirst/NextChild() 2nd argument now has type wxTreeItemIdValue
177 and not long, please change declarations of "cookie"s in your code
178 accordingly -- otherwise your code won't work on 64 bit platforms
179- [MSW only] wxWindow::GetUseCtl3D(), GetTransparentBackground() and
180 SetTransparent() as well as wxNO_3D and wxUSER_COLOURS styles
181- wxList keyed interface: use wxHashMap instead
182- wxColourDatabase::FindColour(): use Find() instead (NB: different ret type)
183- wxHashTable::Next: use wxHashTable::Node* or
184 wxHashTable::compatibility_iterator to store the return
185 value
186- wxWave class; use wxSound instead
187- The wxHIDE_READONLY flag for wxFileDialog was not implemented
188 and has now been removed
189- wxTaskBarIcon::OnXXX() virtual methods: use events instead
190
191
192OTHER CHANGES
193=============
194
1952.5.3
196-----
197
198All:
199
200- number of fixes to wxPluginManager (Rick Brice, Hans Van Leemputten)
201- fixed memory leak in wxURL when using a proxy (Steven Van Ingelgem)
202- fixed bug in wxDateTime::Set(jdn) when DST was in effect
203- fixed fatal bug in wxString when wxUSE_STL==1 (Kurt Granroth)
204- support msgids in charsets other than C and languages other than English
205 (based on patch by Stefan Kowski)
206- added wxMicroSleep() and wxMilliSleep() replacing deprecated wxUsleep()
207
208All (GUI):
209
210- added wxWindow::MoveBefore/AfterInTabOrder() to change tab navigation order
211- added wxTaskBarIcon::CreatePopupMenu which is now recommended way
212 of showing popup menu; calling wxTaskBarIcon::PopupMenu directly
213 is discouraged
214- added ..._CMD_...(id) variants for wxGrid event table entry macros
215- added wxWindow::Navigate for programmatic navigation to the next control.
216- wxTextCtrl::OnChar now inserts a tab character if wxTE_PROCESS_TAB is set
217- added wxKeyEvent::GetUnicodeKey()
218- added wxKeyEvent::CmdDown() and wxMouseEvent::CmdDown()
219
220Unix:
221
222- wxTaskBarIcon now supports freedesktop.org System Tray protocol
223- security fixes to wxSingleInstanceChecker
224- wx-config script was modified to allow choosing from multiple installed
225 builds of wxWidgets
226
227wxGTK:
228
229- fixed many rendering artifacts and wrong colours with lots of GTK+ themes
230- implemented wxColourDialog as native dialog
231- wxTreeCtrl::GetCount() counts root as well now (compatible with MSW)
232- added support for wxCHK_3STATE style (GTK2 only)
233- implemented text underlining under GTK2
234- implemented wxFRAME_NO_TASKBAR style (GTK >= 2.2)
235- implemented support for wxSYS_DCLICK_?, wxSYS_DRAG_? and wxSYS_CURSOR_?
236 in wxSystemSettings::GetMetric (Mart Raudsepp)
237- wxGTK uses GTK+ 2.x by default now, you have to pass --disable-gtk2 to
238 configure if you want to use GTK+ 1.2
239- implemented wxTopLevel::IsMaximized() for GTK+2 and WMs that implement
240 freedesktop.org's wm-spec (Mart Raudsepp)
241
242wxMotif:
243
244- added support for wxCHK_3STATE style (3 state checkbox)
245
246wxMSW:
247
248- fixed UNC paths handling in wxFileSystem (Daniel Nash)
249- set wxKeyEvent::m_uniChar in Unicode build
250
251wxWinCE:
252
253- added automatized but customizable handling of native SmartPhone menus
254
255wxHTML:
256
257- added support for nested index entries and index entries pointing to more
258 than one page to wxHtmlHelpController
259
260
2612.5.2
262-----
263
264All:
265
266- Hindi translation added (Dhananjaya Sharma)
267- Brazilian Portuguese translation added (E. A. Tacao)
268- wxDynamicCast() now uses static_cast<wxObject *> internally and so using it
269 with anything not deriving from wxObject will fail at compile time (instead
270 of run-time) now
271- when wxUSE_STL == 1 and STL provides quasi-standard hash_map/hash_set,
272 wxHashMap/wxHashSet are just typedefs for them. This makes impossible
273 to forward declare these classes.
274
275All (GUI):
276
277- wxHtmlWindow now delays image scaling until rendering,
278 resulting in much better display of scaled images
279- Added UpdateSize to wxSplitterWindow to allow layout while hidden
280- implemented Freeze/Thaw() for wxGenericTreeCtrl (Kevin Hock)
281- support for KOI8-U encoding added (Yuriy Tkachenko)
282- The old wxADJUST_MINSIZE behaviour is now the default behaviour for
283 sizer items that are windows. This means that GetAdjustedBestSize
284 will now be called by default to determine the minimum size that a
285 window in a sizer should have. If you want to still use the initial
286 size (and not the BestSize) then use the wxFIXED_MINSIZE flag. When
287 windows are added to a sizer their initial size is made the window's
288 min size using SetSizeHints, and calls to wxSizer::SetItemMinSize
289 are also forwarded to SetSizeHints for window items.
290- added wxRegEx::GetMatchCount()
291- it is now possible to display images in wxHtmlListBox
292
293wxMSW:
294
295- wxWindow::Freeze()/Thaw() can now be nested
296- Added wxSP_NO_XP_THEME style to wxSplitterWindow to switch off
297 XP theming (some applications look bad without 3D borders)
298- wxMenuBar::GetLabelTop() doesn't include '&'s in the label any more
299- wxRegConf couldn't read global settings without admin privileges and didn't
300 even try to do it by default -- now it does
301- wxTaskBarIcon must be explicitly destroyed now, otherwise the application
302 won't exit even though there are no top level windows
303- wxFileName::GetModificationTime() works with opened files too now
304- wxDC::GetClippingBox() now works even for clipping regions created by Windows
305- fixed wxFileDataObject in Unicode build (Alex D)
306- subdindented paragraphs support (Tim Kosse)
307
308wxGTK:
309
310- added support for wxTE_RIGHT and wxTE_CENTRE styles under GTK2 (Mart Raudsepp)
311
312wxMotif:
313
314- removed wxMenuItem::DeleteSubMenu()
315- wxButtons use Motif default size, which is smaller than it used to be
316 and closer to wxMSW/wxGTK look. This can be disabled by setting
317 motif.largebuttons system option to 1 (see wxSystemOptions).
318
319wxUniv/X11:
320
321- implemented DrawRoundedRectangle() (clawghoul)
322
323wxHTML:
324
325- improved tables and lists layout algorithms (Tim Kosse)
326- <div> handling fix (Xavier Nodet)
327
328Unix:
329
330- fixed priorities of mailcap entries (David Hart)
331- added "wx-config --libs=std,<extra>" syntax (i.e. support for "std")
332
333wxODBC:
334
335- Full Unicode support is now available
336- BLOB support is working
337
338
3392.5.1
340-----
341
342All:
343
344