2 Qt 3.2 introduces new features as well as many improvements over the
3 3.1.x series. This file gives an overview of the main changes since
4 version 3.1.2. For more details, see the online documentation which
5 is included in this distribution. The documentation is also available
6 at http://qt.nokia.com/doc/
8 The Qt version 3.2 series is binary compatible with the 3.1.x series.
9 Applications compiled for 3.1 will continue to run with 3.2.
11 ****************************************************************************
13 ****************************************************************************
19 New classes have been added to the Qt Library including a
20 class to add splash screens to applications (QSplashScreen), a toolbox
21 widget that provides a column of tabbed widgets (QToolBox), and a
22 class to manage per-thread data storage (QThreadStorage).
24 The SQL module received a fair bit of attention this time. The most
25 notable improvements include a native IBM DB2 driver, complete support
26 for stored procedures including the possibility to access
27 out-parameters, and native support for 64 bit fields without having to
28 convert to or from strings. We also added support for setting
29 connection parameters. This way you can, for example, conveniently
30 open an SSL connection to a MySQL or PostgreSQL database. If you need
31 even more customization, e.g. for an Oracle database, you can set up
32 the connection yourself and instantiate a Qt driver object on top of
33 it. An extended SQL cursor class has been added that makes it more
34 convenient to display result sets from general SQL queries
35 (QSqlSelectCursor). In addition, you can add custom database drivers
36 without compiling them as plugins (see
37 QSqlDatabase::registerSqlDriver()).
39 QLineEdit, the one-line text editor, now supports validation input
40 masks. The feature complements the previous QValidator concept and
41 allows e.g. restriction of input to the IP address format (mask
42 "990.990.990.990;_"), or to ISO date format (mask "0000-90-90;0").
44 Qt's unicode code support has been extended. Most notably, full
45 support for Indic scripts has been added, covering writing systems
46 such as Devanagari, Tamil and Bengali. The group of right to left
47 writing systems has been extended with support for Syriac. Both
48 improvements are available on both Windows with Uniscribe installed,
49 and on Unix/X11 when using XFT with OpenType fonts.
51 All tool classes that support STL-like iterators with begin() and
52 end(), contain two extra functions constBegin() and constEnd(). The
53 const versions always return const iterators, and thus can be a little
54 bit faster with Qt's implicitly shared containers.
56 QPainter's complex drawText() function has been highly
57 optimized. Despite its support for complex unicode scripts, it now
58 performs better than its less unicode-capable counterpart in Qt 2.3.
60 QPixmap now supports pixmaps with alpha channel (semi transparency) on
61 all Windows versions except Windows 95 and Windows NT.
63 The print dialog now supports "selection" as a print range as well as
64 the possibility to enable/disable all different printer options
67 Many classes were improved; see the detailed overview that follows.
72 Dialog handling has matured and has been extended since the
73 extension's introduction in Qt 3.1. The documentation and code
74 examples have been improved, including a walkthrough that covers the
75 complete migration of a real-world Motif example to Qt. The process
76 contains four intermediate steps where the application utilizes both
82 Type handling has been extended on both the container and the server
83 side. The new supported types are byte arrays and 64bit integers. The
84 QAxServer module supports QObject subclasses as return and parameter
85 types of slots, and allows error reporting through COM exceptions.
86 The Designer integration has been extended to support property dialogs
87 implemented by the control server.
92 The popup menu editor has been rewritten. The new editor provides the
93 the ability to add, edit and remove menus and menu items directly in
94 the menubar and in the popup menu. Navigation and editing can be done
95 using either the mouse or the keyboard.
97 The new QWidgetContainerPlugin class provides support for complex
98 custom container widgets in Designer, such as the custom tab widget,
101 The property editor now allows editing of properties with or'd values
104 Designer also supports the new QToolBox widget in a similar fashion to
110 Profiles have been introduced to allow applications to extend the use
111 of Qt Assistant as a help system. Profiles describe the documentation
112 to use so that only application specific documentation will be
113 referenced in an end user installation. Profiles also allow some
114 customization of the look in Qt Assistant. For detailed information,
115 see the helpdemo example in $QTDIR/examples/helpdemo.
117 Profiles replace the content files and categories system. The
118 following command line options are removed since they no longer serve
119 any purpose: addContentFile, removeContentFile, category, and
122 Qt Assistant has multiple tabs for browsing, therefore enabling
123 multiple pages to be browsed without opening a new window.
125 It is possible to specify a default home page.
127 It is possible to specify a PDF reader so that urls to PDF files can
128 be opened from Qt Assistant.
130 ****************************************************************************
132 ****************************************************************************
134 - QAction / QActionGroup
135 Simplified constructors so that it is no longer necessary to
136 specify texts for buttons and menu items separately.
137 For action groups, we fixed the enable/disable behavior. If
138 an action inside an action group is explicitly disabled, it is
139 no longer implicitly enabled together with the group.
140 This is identical to enabling/disabling widgets and their
144 Added the aboutQt() slot for convenience.
147 Added the new function, setArguments(), that invokes Qt
148 Assistant in different modes.
151 Added the new function, asVariant(), that passes a COM
152 object through dynamicCall().
155 Added the new function, reportError(), that sends error
156 information to the ActiveX client.
159 Added the new static function, colorNames(), that retrieves a
160 list of all color names known to Qt.
163 Now also supports QDir, QFileInfo, and QStringList.
166 Now has long and ulong support for setAttribute() and
170 Added the new properties: stretch and overline. Added the new
171 function, resolve(), that copies unspecified attributes from
175 Added a new overload for families() that restricts the
176 returned list to fonts supporting a specific QFont::Script,
177 e.g. QFont::Greek, QFont::Devanagari or QFont::Arabic.
179 - QFontInfo / QFontMetrics
180 Added new constructors that force the info and metrics objects
181 to use a given QFont::Script.
184 Added a new constructor that takes a QGLContext
185 parameter. Makes the undocumented setContext() obsolete.
188 Added getters for the sort indicator (sortIndicatorSection()
189 and sortIndicatorOrder() ).
192 Added a new overload for save() that writes to a given
196 Added tristate support to check list items
197 (QCheckListItem::setTristate()). Added the new function,
198 setSelectionAnchor(), to set the list view's selection anchor
202 Added input masks: setInputMask(), inputMask(), and
203 hasAcceptableInput().
206 Added the new static function, question(), that complements
207 the existing information(), warning() and fatal() functions.
209 - QMotifDialog [Qt Motif Extension]
210 Now has two distinct modes of operation: 1) it allows a Motif
211 dialog to have a Qt parent, and 2) it allows a Qt dialog to have
215 Added the new function, remove(), to explicitly remove a
216 pixmap from the cache.
219 Added the new functions: setPrintRange(), printRange(),
220 setOptionEnabled(), and optionEnabled(). For Windows only,
221 added the new function, setWinPageSize(), that allows setting
222 DEVMODE.dmPaperSize directly.
225 Added STL-like iterators with begin(), end(), and erase().
228 Maintains a user defined size policy when the direction
231 - QSplashScreen [new]
232 This new widget class provides a splash screen to be shown
233 during application startup.
236 Added the new properties: opaqueResize, childrenCollapsible,
240 Added a couple of convenience functions: text(), which returns
241 the concatenated database and driver texts. showMessage(),
242 which will pop up a QMessageBox with the text that text()
246 Added overloads for the bindValue() call which makes it
247 possible to specifiy what role a bound value should have: In,
250 - QSqlSelectCursor [new]
251 This new QSqlCursor subclass provides browsing of general SQL
255 Added 64 bit support. Added the new functions: multiArg(),
256 reserve(), capacity(), squeeze(). Added case insensitive
257 overloads for startsWith() and endsWidth().
260 Added the new function gres().
263 Added support for toolbox, header, MDI frame, table grid line
264 color, line edit password character, and message box question.
267 Added the new function, currentParagraph().
270 Added support for custom widgets to be placed beside
271 the tab bar: setCornerWidget() and cornerWidget().
274 In Log mode, added the new functions: setMaxLogLines() and
277 - QThreadStorage [new]
278 This new tool class provides per-thread data storage, also
279 referred to as thread local storage or TLS.
282 This new widget class provides a column of tabbed widgets, one
283 above the other, with the current page displayed below the
287 Added support for LongLong and ULongLong.
290 Added a new widget flag, WNoAutoErase, that combines the now
291 obsolete WResizeNoErase and WRepaintNoErase flags.
293 - QWidgetContainerPlugin [new]
294 This new plugin class complements QWidgetPlugin for custom
295 container widgets, i.e. widgets that can host child