Qt 3.0 adds a wide range of major new features as well as substantial

improvements over the Qt 2.x series. Some internals have undergone

major redesign and new classes and methods have been added.

The Qt version 3.x series is not binary compatible with the 2.x

series.  This means programs compiled with Qt version 2.x must be

recompiled to work with Qt 3.0.

In addition to the traditional Qt platforms Linux, Unix and the

various flavours of MS-Windows.  Qt 3.0 for the first time introduces a

native port to MacOS X. Like all Qt versions, Qt/Mac is source

compatible with the other editions and follows closely the platform's

native look and feel guidelines.

We have tried to keep the API of Qt 3.0 as compatible as possible with

the Qt 2.x series. For most applications, only minor changes will be

needed to compile and run them successfully using Qt 3.0.

One of the major new features that has been added in the 3.0 release

is a module allowing you to easily work with databases. The API is

platform independent and database neutral. This module is seamlessly

integrated into Qt Designer, greatly simplifying the process of

building database applications and using data aware widgets.

Other major new features include a plugin architecture to extend Qt's

functionality, for styles, text encodings, image formats and database

drivers. The Unicode support of Qt 2.x has been greatly enhanced, it

now includes full support for scripts written from right to left

(e.g. Arabic and Hebrew) and also provides improved support for Asian

languages.

Many new classes have been added to the Qt Library. Amongst them are

classes that provide a docking architecture (QDockArea/QDockWindow), a

powerful rich text editor (QTextEdit), a class to store and access

application settings (QSettings) and a class to create and communicate

with processes (QProcess).

Apart from the changes in the library itself a lot has been done to

make the development of Qt applications with Qt 3.0 even easier than

before. Two new applications have been added: Qt Linguist is a tool to

help you translate your application into different languages; Qt

Assistant is an easy to use help browser for the Qt documentation that

supports bookmarks and can search by keyword.

Another change concerns the Qt build system, which has been reworked

to make it a lot easier to port Qt to new platforms. You can use this

platform independent build system - called qmake - for your own

applications.

And last but not least we hope you will enjoy the revisited and widely

extended documentation.

Qt/Embedded

----------

Qt/Embedded 3.0 provides the same features as Qt 3.0, but currently

lacks some of the memory optimizations and fine-tuning capabilities of

Qt/Embedded 2.3.x. We will add these in the upcoming maintainance

releases.

If you develop a new product based on Qt/Embedded, we recommend

switching to 3.0 because of the greatly improved functionality.

However, if you are planning a release within the next two months and

require memory optimizations not available with Qt/Embedded 3.0, we

suggest using Qt/Embedded 2.3.x.

The Qt Library

========================================

A large number of new features has been added to Qt 3.0. The following

list gives an overview of the most important new and changed aspects

of the Qt library.

Database support

----------------

One of the major new features in Qt 3.0 is the SQL module that

provides cross-platform access to SQL databases, making database

application programming with Qt seamless and portable. The API, built

with standard SQL, is database-neutral and software development is

independent of the underlying database.

A collection of tightly focused C++ classes are provided to give the

programmer direct access to SQL databases. Developers can send raw SQL

to the database server or have the Qt SQL classes generate SQL queries

automatically.  Drivers for Oracle, PostgreSQL, MySQL and ODBC are

available and writing new drivers is straightforward.

Tying the results of SQL queries to GUI components is fully supported

by Qt's SQL widgets. These classes include a tabular data widget

(for spreadsheet-like data presentation with in-place editing), a

form-based data browser (which provides data navigation and edit

functions) and a form-based data viewer (which provides read-only

forms). This framework can be extended by using custom field editors,

allowing for example, a data table to use custom widgets for in-place

editing. The SQL module fully supports Qt's signals/slots mechanism,

making it easy for developers to include their own data validation and

auditing code.

Qt Designer fully supports Qt's SQL module. All SQL widgets can be

laid out within Qt Designer, and relationships can be established

between controls visually. Many interactions can be defined purely in

terms of Qt's signals/slots mechanism directly in Qt Designer.

Explicit linking and plugins

-------------------------

The QLibrary class provides a platform independent wrapper for runtime

loading of shared libraries.

Specialized classes that make it possible to extend Qt's functionality

with plugins: QStylePlugin for user interface styles, QTextCodecPlugin

for text encodings, QImageFormatPlugin for image formats and

QSqlDriverPlugin for database drivers.

It is possible to remove unused components from the Qt library, and

easy to extend any application with 3rd party styles, database drivers

or text codecs.

Qt Designer supports custom widgets in plugins, and will use the

widgets both when designing and previewing forms (QWidgetPlugin).

Rich text engine and editor

---------------------------

The rich text engine originally introduced in Qt 2.0 has been further

optimized and extended to support editing. It allows editing formatted

text with different fonts, colors, paragraph styles, tables and

images. The editor supports different word wrap modes, command-based

undo/redo, multiple selections, drag and drop, and many other

features.  The engine is highly optimized for proccesing and displaying

large documents quickly and efficiently.

Unicode

-------

Apart from the rich text engine, another new feature of Qt 3.0 that

relates to text handling is the greatly improved Unicode support. Qt

3.0 includes an implementation of the bidirectional algorithm (BiDi)

as defined in the Unicode standard and a shaping engine for Arabic,

which gives full native language support to Arabic and Hebrew speaking

people. At the same time the support for Asian languages has been

greatly enhanced.

The support is almost transparent for the developer using Qt to

develop their applications. This means that developers who developed

applications using Qt 2.x will automatically gain the full support for

these languages when switching to Qt 3.0. Developers can rely on their

application to work for people using writing systems different from

Latin1, without having to worry about the complexities involved with

these scripts, as Qt takes care of this automatically.

Docked and Floating Windows

---------------------------

Qt 3.0 introduces the concept of dock windows and dock areas. Dock

windows are widgets, that can be attached to, and detached from, dock

areas. The most common kind of dock window is a tool bar. Any number of

dock windows may be placed in a dock area. A main window can have dock

areas, for example, QMainWindow provides four dock areas (top, left,

bottom, right) by default. The user can freely move dock windows and

place them at a convenient place in a dock area, or drag them out of

the application and have them float freely as top level windows in

their own right. Dock windows can also be minimized or hidden.

For developers, dock windows behave just like ordinary widgets. QToolbar

for example is now a specialized subclass of a dock window.  The API

of QMainWindow and QToolBar is source compatible with Qt 2.x, so

existing code which uses these classes will continue to work.

Regular Expressions

-------------------

Qt has always provided regular expression support, but that support

was pretty much limited to what was required in common GUI control

elements such as file dialogs. Qt 3.0 introduces a new regular

expression engine that supports most of Perl's regex features and is

Unicode based. The most useful additions are support for parentheses

(capturing and non-capturing) and backreferences.

Storing application settings

----------------------------

Most programs will need to store some settings between runs, for

example, user selected fonts, colors and other preferences, or a list

of recently used files.  The new QSettings class provides a platform

independent way to achieve this goal. The API makes it easy to store

and retrieve most of the basic data types used in Qt (such as basic

C++ types, strings, lists, colors, etc). The class uses the registry

on the Windows platform and traditional resource files on Unix.

Creating and controlling other processes

----------------------------------------

QProcess is a class that allows you to start other programs from

within a Qt application in a platform independent manner. It gives you

full control over the started program.  For example you can redirect

the input and output of console applications.

Accessibility

---------------

Accessibility means making software usable and accessible to a wide

range of users, including those with disabilities. In Qt 3.0, most

widgets provide accessibility information for assistive tools that can

be used by a wide range of disabled users. Qt standard widgets like

buttons or range controls are fully supported. Support for complex

widgets, like e.g. QListView, is in development. Existing applications

that make use of standard widgets will become accessible just by using

Qt 3.0.

Qt uses the Active Accessibility infrastructure on Windows, and needs

the MSAA SDK, which is part of most platform SDKs. With improving

standardization of accessibility on other platforms, Qt will support

assistive technologies on other systems too.

XML Improvements

----------------

The XML framework introduced in Qt 2.2 has been vastly improved. Qt

2.2 already supported level 1 of the Document Object Model (DOM), a

W3C standard for accessing and modifying XML documents.  Qt 3.0 has

added support for DOM Level 2 and XML namespaces.

The XML parser has been extended to allow incremental parsing of XML

documents. This allows you to start parsing the document directly

after the first parts of the data have arrived, and to continue

whenever new data is available.  This is especially useful if the XML

document is read from a slow source, e.g. over the network, as it

allows the application to start working on the data at a very early

stage.

SVG support

-----------

SVG is a W3C standard for "Scalable Vector Graphics". Qt 3.0's SVG

support means that QPicture can optionally generate and import static

SVG documents. All the SVG features that have an equivalent in

QPainter are supported.

Multihead support

-----------------

Many professional applications, such as DTP and CAD software, are able

to display data on two or more monitors. In Qt 3.0 the QDesktopWidget

class provides the application with runtime information about the

number and geometry of the desktops on the different monitors and such

allows applications to efficiently use a multi-monitor setup.

The virtual desktop of Windows 98 and 2000 is supported, as well as

the traditional multi-screen and the newer Xinerama multihead setups

on X11.

X11 specific enhancements

-------------------------

Qt 3.0 now complies with the NET WM Specification, recently adopted

by KDE 2.0.  This allows easy integration and proper execution with

desktop environments that support the NET WM specification.

The font handling on X11 has undergone major changes.  QFont no longer

has a one-to-one relation with window system fonts.  QFont is now a

logical font that can load multiple window system fonts to simplify

Unicode text display.  This completely removes the burden of

changing/setting fonts for a specific locale/language from the

programmer.  For end-users, any font can be used in any locale.  For

example, a user in Norway will be able to see Korean text without

having to set their locale to Korean.

Qt 3.0 also supports the new render extension recently added to

XFree86. This adds support for anti-aliased text and pixmaps with

alpha channel (semi transparency) on the systems that support the

rendering extension (at the moment XFree 4.0.3 and later).

Printing

--------

Printing support has been enhanced on all platforms. The QPrinter

class now supports setting a virtual resolution for the painting

process. This makes WYSIWYG printing trivial, and also allows you to

take full advantage of the high resolution of a printer when painting

on it.

The postscript driver built into Qt and used on Unix has been greatly

enhanced. It supports the embedding of true/open type and type1 fonts

into the document, and can correctly handle and display Unicode.

Support for fonts built into the printer has been enhanced and Qt now

knows about the most common printer fonts used for Asian languages.

Networking

-----------

A new class QHttp provides a simple interface for HTTP downloads and

uploads.

Compatibility with the Standard Template Library (STL)

------------------------------------------------------

Support for the C++ Standard Template Library has been added to the Qt

Template Library (QTL).  The QTL classes now contain appropriate copy

constructors and typedefs so that they can be freely mixed with other

STL containers and algorithms.  In addition, new member functions have

been added to QTL template classes which correspond to STL-style

naming conventions (e.g., push_back()).

Qt Designer

========================================

Qt Designer was a pure dialog editor in Qt 2.2 but has now been

extended to provide the full functionality of a GUI design tool.

This includes the ability to lay out main windows with menus and

toolbars. Actions can be edited within Qt Designer and then plugged

into toolbars and menu bars via drag and drop. Splitters can now be

used in a way similar to layouts to group widgets horizontally or

vertically.

In Qt 2.2, many of the dialogs created by Qt Designer had to be

subclassed to implement functionality beyond the predefined signal and

slot connections. Whilst the subclassing approach is still fully

supported, Qt Designer now offers an alternative: a plugin for editing

code. The editor offers features such as syntax highlighting,

completion, parentheses matching and incremental search.

The functionality of Qt Designer can now be extended via plugins.

Using Qt Designer's interface or by implementing one of the provided

interfaces in a plugin, a two way communication between plugin and Qt

Designer can be established. This functionality is used to implement

plugins for custom widgets, so that they can be used as real widgets

inside the designer.

Basic support for project management has been added. This allows you

to read and edit *.pro files, add and remove files to/from the project

and do some global operations on the project. You can now open the

project file and have one-click access to all the *.ui forms in the

project.

In addition to generating code via uic, Qt Designer now supports the

dynamic creation of widgets directly from XML user interface

description files (*.ui files) at runtime. This eliminates the need of

recompiling your application when the GUI changes, and could be used

to enable your customers to do their own customizations. Technically,

the feature is provided by a new class, QWidgetFactory in the

UI-library.

Qt Linguist

========================================

Qt Linguist is a GUI utility to support translating the user-visible

text in applications written with Qt. It comes with two command-line

tools: lupdate and lrelease.

Translation of a Qt application is a three-step process:

  1) Run lupdate to extract user-visible text from the C++ source

     code of the Qt application, resulting in a translation source file

     (a *.ts file).

  2) Provide translations for the source texts in the *.ts file using

     Qt Linguist.

  3) Run lrelease to obtain a light-weight message file (a *.qm file)

     from the *.ts file, which provides very fast lookup for released

     applications.

Qt Linguist is a tool suitable for use by translators. Each

user-visible (source) text is characterized by the text itself, a

context (usually the name of the C++ class containing the text), and

an optional comment to help the translator. The C++ class name will

usually be the name of the relevant dialog, and the comment will often

contain instructions that describe how to navigate to the relevant

dialog.

You can create phrase books for Qt Linguist to provide common

translations to help ensure consistency and to speed up the

translation process. Whenever a translator navigates to a new text to

translate, Qt Linguist uses an intelligent algorithm to provide a list

of possible translations: the list is composed of relevant text from

any open phrase books and also from identical or similar text that has

already been translated.

Once a translation is complete it can be marked as "done"; such

translations are included in the *.qm file. Text that has not been

"done" is included in the *.qm file in its original form. Although Qt

Linguist is a GUI application with dock windows and mouse control,

toolbars, etc., it has a full set of keyboard shortcuts to make

translation as fast and efficient as possible.

When the Qt application that you're developing evolves (e.g. from

version 1.0 to version 1.1), the utility lupdate merges the source

texts from the new version with the previous translation source file,

reusing existing translations. In some typical cases, lupdate may

suggest translations. These translations are marked as unfinished, so

you can easily find and check them.

Qt Assistant

========================================

Due to the positive feedback we received about the help system built

into Qt Designer, we decided to offer this part as a separate

application called Qt Assistant. Qt Assistant can be used to browse

the Qt class documentation as well as the manuals for Qt Designer and

Qt Linguist. It offers index searching, a contents overview, bookmarks

history and incremental search. Qt Assistant is used by both Qt

Designer and Qt Linguist for browsing their help documentation.

qmake

========================================

qmake is a cross-platform make utility that makes it possible to build

the Qt library and Qt-based applications on various target platforms

from one single project description. It is the C++ successor of

'tmake' which required Perl.

qmake offers additional functionallity that is difficult to reproduce

in tmake. Trolltech uses qmake in its build system for Qt and related

products and we have released it as free software.

Detailed changes

=============

Qt 3.0 went through 6 beta releases. These are the detailed changes

since Beta 6 only. For other changes, please see the changes notes

of the respective beta releases.

Qt 3.0 final is not binary compatible with Beta6; any programs linked

against Beta6 must be recompiled.

Below you will find a description of general changes in the Qt

Library, Qt Designer and Qt Assistant.  Followed by a detailed list of

changes in the API.

****************************************************************************

*			    General					   *

****************************************************************************

****************************************************************************

*			   Library					   *

****************************************************************************

- QApplication

	make sure we process deferred deletes before leaving the event

	loop. This fixes some ocassions of memory leaks on exit.

	win32: some improvements for modality and dockwindow handling

	x11 only: read non-gui QSettings when running without GUI.

- QCheckListItem

	Make the checkboxes respect the AlignCenter flag. Also make

	the boxes look better in case they are not placed in the first

	column.

- QComboBox

	if we have a currentItem and then we set the combobox to be

	editable then set the text in the lineedit to be of the

	current item.

- QCommonStyle

	QToolButton: spacing between a toolbutton's icon and its label.

	QProgressBar: text color fixed.

- QCursor

	added the What's This? cursor to the collection.

- QDataTable

	fixed broken context menus.

- QDate

	fixed addMonth() overflow.

- QDesktopWidget

	win32 only: works now also for cases where the card handles

	multiple monitors and GetSystemMetrics returns a single screen

	only.

- QDomAttr

	fixed a memory leak in setNodeValue()

- QDomNodeMap

	added count() as a Qt-style alias for length()

- QDragObject

	default to the middle of the pixmap as a hot spot, this looks

	nicer.

- QFileDialog (internal dialog)

	make viewMode() return the correct value even after the dialog

	is finished. Fixed getOpenFileName and getSaveFileName for

	non-existant directories. Make sure that when it's in

	directory mode that the filters reflect this, and change the

	label from file name to directory.

	win32 only: Improved modality when using the native file

	dialog.

- QFont

	x11 only: speed up fontloading with even more clever

	caching. Make sure we can match scaled bitmap fonts by

	default. Do not load a backup font for a script that is not

	default. Make sure the pixel size is correct, even for fonts

	that are unavailable. Try even harder to find a fontname that

	is not understood. Some RENDER performance optimizations.

- QFontDialog

	make sure the content is set up correctly when initializing

	the dialog.

- QGLWidget

	IRIX only: fixed reparent/resize bug, QGLContext::setContext()

	is incredibly sensitive on different X servers.

- QHeader

	fixed missing updates on height resp. width changes like the

	occur when changing the application font.

- QIconView

	fixed updates of non-auto-arranged views.

- QImage

	no gamma correction by default.

	x11 only: some alignment issue with the alpha masked fixed.

- QIODevice

	fixed return value of QIODevice::readLine() for sequential

	access.

- QKeyEvent

	win32 only: generate Direction_R/L events for bidirectional

	input.

- QLabel

	handle setPixmap( *pixmap() ) gracefully. Apply the WordBreak

	alignment flag to both plaintext and richtext. Improved alignment of

	richtext labels. Removed some sizepolicy magic, QLabel now

	works fine with Preferred/Preferred in all modes.

- QLineEdit

	fixed a crash when doing undo and a validator is set. Emit

	textChanged() also if the text changed because of undo or redo.

- QListBox

	fixed RMB context-menu offset.

- QListView

	do not start renaming an item is CTRL or SHIFT is

	pressed. Start renaming on mouse release, not mouse press, so

	click + click + move on the same item does not start a rename

	operation.

- QMainWindow

	show dock-menu also when clicking on the menubar.

- QPainter

	win32 only: improved printing performance through printer font

	caching.

	boundingRect(): ignore 0-width in the constrain rectangle.

- QPicture

	added overload for load()  that takes a QIODevice.

- QPrintDialog (internal dialog)

	fixed enabling of the first page and last page labels.

- QPrinter

	win32 only: make setColorMode() work, some unicode fixes. Make

	collate the default.  Enable the collate checkbox without

	losing the page selection if you want to print multiple

	pages. Make the collateCopies property work that it knows

	checks/unchecks the collate checkbox in the printing

	dialog. Make settings also work when the print dialog is not

	shown at all.

- QProcess

	added a new communication mode that duplicates stderr to

	stdout (i.e. the equivalent of the shell's 2>&1).

- QPSPrinter (unix)

	fixed collate.

- QRangeControl

	simplified code.

- QRichText

	Propagate WhiteSpaceMode to subitems with

	WhiteSpaceModeNormal. Hide DisplayModeNone

	items without additional newline. Fixed links inside non-left

	aligned tables. Fixed some bidi layout problems. Fixed last

	line layout in right-aligned paragraphs. For plain text,

	always use the palette's text color.

- QScrollView

	safer destruction.

- QSettings

	win32 only: fixed a dead lock situation when writing

	to LOCAL_MACHINE, but reading from CURRENT_USER.

- QSGIStyle

	fixed drawing of checkable menu items.

- QSimpleRichText

	use the specified default font.

- QSlider

	optimized drawing in the new style engine.

- QString

	QString::replace() with a regular expression requires a

	QRegExp object, passing a plain string will cause a compile

	error.

- QStyleSheet

	additional parameter 'whitespacemode' for

	QStyleSheet::convertFromPlainText(). Support for superscript

	('sup') and subscript ( 'sub' ).

- QTabBar

	react properly on runtime font changes, less flicker.

- QTable

	take the pixmap of a header section into account when

	adjusting the size.

- QTabWidget

	use the embedded tabbar as focus proxy.

- QThread

	win32 only: possible crash with the thread dictionary fixed.

- QValidator

	In Q{Int,Double}Validator, consider '-' as Invalid rather than

	Intermediate if bottom() >= 0.

- QWidget

	made showFullScreen() multihead aware.

	win32 only: Better size and position restoring when switching

	between fullscreen, maximized and minimized.

	x11 only: improvements to XIM, overthespot works correctly

	now.

- QWorkspace

	smarter placement of the minimize button when there is no

	maximize button. Make titlebars of tool windows a bit smaller.

	Improved styleability. Do not maximize a widget that has a

	maximum size that is smaller than the workspace.

****************************************************************************

*			      Other					   *

****************************************************************************

- moc

	fixed generation of uncompilable code in conjunction with

	Q_ENUMS and signal/slots.

- unicode

	allow keyboard switching of paragraph directionality.

- installation

	install $QTDIR/doc/html/ instead of $QTDIR/doc/

	install Qt Designer templates as well.

- improved build on

	HP-UX with cc.

	Solaris 8 with gcc 3.0.1.

	AIX with xlC and aCC.

- inputmethods

	x11 only: do not reset the input context on focus changes.

- uic

	smaller improvements, handle additional form signals.

- Qt Designer

	make it possible to add new signals to a form without

	subclassing. Minor fixes.

- Qt Assistant

	fixed Shift-LMB selection bug. Fixed new window and window

	restoration on restart.

- Qt Linguist

	change fourth parameter of QApplication::translate() from bool

	to enum type. This affects MOC (new revision) and lupdate (new

	syntax to parse). Change Qt Linguist's XML file format (.ts)

	to be consistent with QApplication:<defaultcodec> (rather than

	<codec>) to match QApp::defaultCodec(); encoding="UTF-8"

	(rather than utf8="true") to match QApp::translate(). Fixed

	window decoration on restart. Use 'finished', 'unfinished' and

	'unresolved' instead of the (!), (?) symbols on printouts.

- QMsDev

	merge "Add UIC" and "New Dialog". Better user interface and

	general cleanup. Wwrite (and merge) qmake pro file with active

	project. Load qmake pro files into Visual Studio.