Qt 4.1 introduces many new features as well as many improvements and

bugfixes over the 4.0.x series. For more details, see the online

documentation which is included in this distribution. The

documentation is also available at http://qt.nokia.com/doc/

The Qt version 4.1 series is binary compatible with the 4.0.x series.

Applications compiled for 4.0 will continue to run with 4.1.

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

*                           General                                        *

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

Qt library

----------

- Introduced widget backing store support, allowing semi-transparent

  (alpha-blended) child widgets and faster widget painting, as well

  as solving long-lasting issues with non-rectangular widgets.

- Integrated support for rendering Scalable Vector Graphics (SVG)

  drawings and animations (QtSvg module).

- A Portable Document Format (PDF) backend for Qt's printing system.

- A unit testing framework for Qt applications and libraries.

- Modules for extending Qt Designer and dynamic user interface

  building.

- Additional features for developers using OpenGL, such as support

  for pixel and sample buffers.

- A flexible syntax highlighting class based on the Scribe rich text

  framework.

- Support for network proxy servers using the SOCKS5 protocol.

- Support for OLE verbs and MIME data handling in ActiveQt.

- Support for universal binaries on Mac OS X.

Qt Designer

-----------

- Added support for editing menu bars and tool bars.

- Added support for adding comments to string properties.

- Added new static QtUiTools library with improved

  QUiLoader API for loading designer forms at run-time.

- Added support for namespaces in uic generated code.

- Added support for dock widgets in main windows.

- Added support for editing table, tree and list widgets.

- Improved palette editing and resource support.

QTestLib

--------

- Added QTestLib, the Qt Unit Testing Library. See the "QTestLib"

  chapter in the Qt documentation for more information.

- Users of older versions of QtTestLib can use the updater utility in

  tools/qtestlib/updater to convert existing autotests to work with

  QTestLib.

Boost

-----

Added boost compatible syntax for declaring signals and slots. If you

define the macro QT_NO_KEYWORDS, "Q_SIGNALS" and "Q_SLOTS" are

recognized as keywords instead of the default "signals" and "slots".

Added a new keyword to qmake to enable this macro: CONFIG += no_keywords.

ActiveQt

--------

QAxServer now supports mime-type handling - a ActiveX control can be

registered to handle a certain file extension and mime-type, in which

case QAxBindable::load and QAxBindable::save can be reimplemented to

serialize the object.

Build system

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

Added support for linking static plugins into the application.

Qt 3 to 4 Porting Tool

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

Q(V|H)BoxLayout and QGridLayout usage is now ported to use

Q3(V|H)BoxLayout/Q3GridLayout, to retain the margin/spacing behavior

as in Qt 3.

Meta Object Compiler (moc)

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

- Added support for const signals.

Qt Assistant

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

- Added -docPath command line option for easy setting of the

  document root path.

QMake

-----

- Added support for new FORMS3 profile variable to make it possible

  to have Qt Designer forms from Qt 3 and Qt 4 in the same project.

- Added support for precompiled headers on win32-g++ (MinGW)

Compilers

---------

Added support for Solaris 10 on AMD64 with the compiler provided by

Sun.

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

*                          Library                                         *

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

New classes

-----------

- QTreeWidgetItemIterator

        Added iterator to help iterating over items in a QTreeWidget.

- QStringFilterModel

        Allows you to provide a subset of a model to a view based on a

        regular expression.

- QSyntaxHighlighter

        The QSyntaxHighlighter class allows you to define syntax

        highlighting rules.

- QAbstractFileEngine

        A base class for implementing your own file and directory

        handling back-end for QFile, QFileInfo and QDir.

- QAbstractFileEngineHandler

        For registering a QAbstractFileEngine subclass with Qt.

- QFSFileEngine

        The default file engine for regular file and directory access

        in Qt.

- Q3(H|V)BoxLayout and Q3GridLayout

        Layout classes provided for compatibility that behave the same

        as the Qt 4 classes but use a zero margin/spacing by default,

        just like in Qt 3.

- Added qFromLittleEndian, qToLittleEndian, qFromBigEndian and

  qToBigEndian endian helper conversion functions (qendian.h)

- Q_EXPORT_PLUGIN2 macro

        Obsoletes Q_EXPORT_PLUGIN and allows static linking of

        plugins.

- Q3ComboBox

        For enhanced backwards compatibility with Qt 3.

- QGLPbuffer

        For creating and managing OpenGL pixel buffers.

- QNetworkProxy

        For setting up transparent (SOCKS5) networking proxying.

- QDirectPainter (Qtopia Core only)

        Provides direct access to video framebuffer hardware.

General improvements

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

- QByteArray

        Added toLong() and 

- QColorDialog

        Fix shortcut and focus for "Alpha channel" spinbox.

- QLinkedList

        Added conversion methods to convert from/to STL lists.

- QMap/QHash

        Fixed operator>>() to read back multiple values associated

        to a same key correctly.

        Added constFind(), for finding an item without causing a

        detach.

- QMap/QHash

        Const-correctness in const_iterator's operator--(int).

- QMainWindow

        The saveState() and restoreState() functions no longer

        fallback to using the windowTitle property when the objectName

        property is not set on a QToolBar or QDockWidget; this

        behavior was undocumented and has been removed.

- QToolBar

        Added Qt 3 compatibility signal visibilityChanged(bool).

- QMetaType

        Class is now fully reentrant.

        Metatypes can be registered or queried from multiple threads.

        Added qMetaTypeId<T>(), which returns the meta type ID of T at

        compile time.

- QMetaProperty

        Added isResettable().

- QSql

        Oracle plugin adds support for authentication using external

        credentials.

        Added isValid() to QSqlError.

- QThread

        Added setPriority() and priority(), for querying and setting

        the priority of a thread.

- QTreeWidgetItem/QTreeWidget

        Added new constructors and addChildren(), insertChildren(),

        takeChildren(), insertTopLevelItems(), addTopLevelItems to

        speed up insertion of multiple items.

- QTextDocument

        Added the class QTextBlockUserData and added the possibility

        of storing a state or custom user data in a QTextBlock

        Added useDesignMetrics property, to enable the use of design

        metrics for all fonts in a QTextDocument.

- QTextFormat

        Added support for setting the font pixel size.

        Added UserObject to QTextFormat::ObjectTypes enum.

- QMetaType

        The value of QMetaTypeId<T>::Defined indicates whether a given

        type T is supported by QMetaType.

- QAbstractItemView

        Added setIndexWidget() and indexWidget() which makes it

        possible to set a widget at a given index.

        Added a QAbstractItemView::ContiguousSelection mode.

        Added scrollToTop() and scrollToBottom().

        Changed signals pressed(), clicked() and doubleClicked() to

        only emit when the index is valid.

- QAbstractItemModel

        Added a SizeHintRole that can be set for each item. The item

        delegate will now check for this value before computing the

        size hint based on other item data.

        Add QModelIndex::operator<() so we are able to use them in

        QMap and other containers.

        Added qHash function for QModelIndex.

- QTableWidget

        Added cellWidget() and setCellWidget() which makes it possible

        to set a widget at a specified cell.

        Added setCurrentCell().

        Added QTableWidgetItem copy constructors.

- QTreeWidget

        Added setItemWidget() and itemWidget() which makes it possible

        to set a widget on an item.

- QListWidget

        Added setItemWidget() and itemWidget() which makes it possible

        to set a widget on an item.

        Added QListWidgetItem copy constructors.

- QMutableMapIterator

        Added value() overloads to Java-style iterators that return

        non-const references.

- QTextTable

        Added mergeCells() and splitCells() to be able to set the row

        or column span on a table cell.

- QStyle

        Added standardIcon() which returns a default icon for standard

        operations.

        Added State_ReadOnly, which is enabled for read-only widgets.

        Renamed QStyleOption::init() to initFrom().

        - QGroupBox is now completely stylable (QStyleOptionGroupBox).

        - QToolBar is now stylable according to its position in the

          toolbar dock area (QStyleOptionToolBar).

        - Indeterminate (busy) progress bars are now animated properly

          in all styles.

        - By popular request, the default toolbar icon size

          (PM_ToolBarIconSize) in Windows and Plastique styles has

          been changed to 24 x 24 (instead of 16 x 16 in Windows and

          32 x 32 in Plastique).

        Added PM_DockWidgetTitleMargin as pixel metric.

- QHash

        Make it possible to use QHash with a type that has no default

        constructor.

- QTableView

        Made QTableView::setShowGrid() a slot, like in Qt 3.

        Added setRowHeight() and setColumnWidth().

- QTableWidgetSelectionRange

        Added rowCount() and columnCount() convenience functions.

- QSettings

        Added support for custom formats in QSettings.

- QTextStream

        Added status(), setStatus() and resetStatus() for improved

        error handling.

        Added read(qint64 maxlen), for reading parts of a text stream

        into a QString.

- QTextCursor

        Added support for BlockUnderCursor selection type.

- QHeaderView

        Added defaultSectionSize property which tells the default size

        of the header sections before resizing.

- QScrollBar

        Added context menu to the scrollbar with default navigation

        options.

- QScrollArea

        Added ensureVisible(), which can scroll the scrollarea to make

        sure a specific point is visible.

- QDateTime

        Added addMSecs(), which adds a number of milliseconds to the QDateTime.

- QDateTimeEdit

        Added support for more date/time formats.

        Now allows multiple sections of the same type.

- QButtonGroup

        Added handling of buttons with IDs to the buttongroup like in

        Qt 3.

- QIODevice

        Added peek() for peeking data from a device.

- QTextEdit

        Added property tabStopWidth which sets the tab stop width in

        pixels.

        append(const QString &) is now a public slot.

        Added support for inserting Unicode control characters through

        the context menu.

        Added property acceptRichText, for whether or not the text

        edit accepts rich text insertions by the user.

        Added overwriteMode property.

- QDataStream

        Added skipRawData().

        Added support for QRegExp.

- QProgressBar

        Added support for vertical progress bars.

- QImageIOHandler

        The name() function has been obsoleted; use format() instead.

        Added QImageIOHandler::Animation, for determining if the image

        format supports animation.

        Added QImageIOHandler::BackgroundColor, for setting the

        background color for the image loader.

- QImageReader

        Added setBackgroundColor() and backgroundColor(), for setting

        the background color of an image before it is read.

        Added supportsAnimation(), for checking if the image format

        supports animation.

- QImageWriter

        Added support for saving image text.

- QLocale

        Added dateFormat()/timeFormat() to query the date/time format

        for the current locale.

        Added toString() overloads for localized QTime and QDate

        output.

        Added decimalPoint(), groupSeparator(), percent(),

        zeroDigit(), negativeSign() and exponential(), which provide a

        means to generate custom number formatting.

- QHostInfo

        Added support for reverse name lookups.

- QHostAddress

        Added a QString assignment operator

        Added convenience functions for initializing from a native

        sockaddr structure.

        Added support for the IPv6 scope-id.

- QPrinter

        Added property "embedFonts" for embedding fonts into the

        target document.

        Added support for printing to PDF.

        Added support for custom print and paint engines

- QPrintEngine

        Added PPK_SuppressSystemPrintStatus, for suppressing the

        printer progress dialog on Mac OS X.

- QKeySequence

        Added fromString() and toString() for initializing a key

        sequence from, and exporting a key sequence to a QString.

- QUrl

        Added the port(int) function, which provides a default value

        for the port if the URL does not define a port.

        Support for decoding Punycode encoded hostnames in URLs.

        Made the parser more tolerant for mistakes, and added a

        ParsingMode flag for selecting strict or tolerant parsing.

        Added support for the NAMEPREP standard in our i18n domain

        name support.

- QDir

        Added the filter QDir::NoDotAndDotDot, for the

        special directories "." and "..".

        Added the filter QDir::AllEntries, for all entries

        in a directory, including symlinks.

- QAbstractSocket

        Added slots connectToHostImplementation() and

        disconnectFromHostImplementation() to provide polymorphic

        behavior for connectToHost() and disconnectFromHost().

- QMenuBar

        Added setActiveAction(), which makes the provided action

        active.

- QProxyModel

        This class has been obsoleted (see QAbstractProxyModel)

- QWidget

        Now supports three modes of modality: NonModal, WindowModal

        and ApplicationModal.

        Added Qt::WindowModality, obsoleted WA_ShowModal and

        WA_GroupLeader.

        Added Qt::WA_OpaquePaintEvent widget attribute, obsoleting

        Qt::WA_NoBackground.

        Added boolean autoFillBackground property.

        Child widgets now always inherit the contents of their parent.

- QPalette

        Added QPalette::Window (obsoletes Background) and

        QPalette::WindowText (obsoletes Foreground).

- QHttpResponseHeader

        Added two constructors and the function setStatusLine() for

        generating a response header.

- QBitArray

        Added count(bool), for counting on and off-bits in a bit

        array.

- QVariant

        Added support for QRegExp

- QRegExpValidator

        Added the property "regExp".

- QTabBar

        Added the property "iconSize", for setting the size of the

        icons on the tabs.

- QLineEdit

        Added support for inserting Unicode control characters through

        the context menu.

- QString

        Added toLong() and toULong().

        Support for std::string conversions with embedded \0

        characters.

- QRegion

        Added translate(), like QRect::translated().

- QProcess

        Added systemEnvironment(), which returns the environment

        variables of the calling process.

        Added exitStatus(), and added a new finished() signal which

        takes the exit status as a parameter.

- QComboBox

        Made setCurrentIndex() a slot.

- QFontDataBase

        Added styleString(), for retrieving the style string from a

        QFontInfo.

        Added support for Myanmar fonts.

- QFontMetrics

        Added xHeight(), which returns the 'X' height of the font.

- QCoreApplication

        Added arguments(), which returns a list of command line

        arguments as a QStringList.

- QTcpSocket

        Added support for SOCKS5 via setProxy().

- QUdpSocket

        Added property "bindMode", for binding several sockets to the

        same address and port.

- QPen

        Added support for custom dash pattern styles and miter limits.

        Added support for QDebug.

- QDebug

        Added support for QVector and QPair output.