Qt 4.5 introduces many new features and improvements as well as bugfixes

over the 4.4.x series. For more details, refer to the online documentation

included in this distribution. The documentation is also available online:

  http://qt.nokia.com/doc/4.5

The Qt version 4.5 series is binary compatible with the 4.4.x series.

Applications compiled for 4.4 will continue to run with 4.5.

Some of the changes listed in this file include issue tracking numbers

corresponding to tasks in the Task Tracker:

  http://qt.nokia.com/developer/task-tracker

Each of these identifiers can be entered in the task tracker to obtain more

information about a particular change.

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

*                           General                                        *

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

General Improvements

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

New features

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

- Disk Caching in QtNetwork

    * Added support for http caching in QNetworkAccessManager.

    * New classes:  QAbstractNetworkCache, QNetworkDiskCache.

    * QNetworkDiskCache is a simple disk-based cache.

- QDate

    * [207690] Added QDate::getDate().

- QDateTimeEdit

    * [196924] Improved QDateTimeEdit's usability. It now skips ahead to the

      next field when input can't be valid for the current section.

- QDateTime

    * [178738] Fixed QDateTime::secsTo() to return the correct value.

- QDBusPendingCall / QDBusPendingCallWatcher / QDBusPendingReply

    * New classes to make calls whose replies can be received later.

- QDesktopServices

    * Added the ability to determine the proper location to store cache files.

- QGraphicsItem

    * Added the QGraphicsItem::itemTransform() function.

    * [209357] Added the QGraphicsItem::opacity() function.

    * [209978] Added the QGraphicsItem::ItemStacksBehindParent flag to allow

      children to be stacked behind their parent item.

    * Added QGraphicsItem::mapRect() functions.

- QGraphicsScene

    * Added the QGraphicsScene::sortCacheEnabled property.

    * Added the QGraphicsScene::stickyFocus property.

- QGraphicsTextItem

    * [242331] Added the QGraphicsTextItem::tabChangesFocus() function.

- QGraphicsView

    * [210121] Added action, shortcut and shortcut override support to

      QGraphicsView and QGraphicsItem.

- QLineEdit

    * Added the ability to set the text margin size.

- QMainWindow

    * Added API to detect which dock widget is tabified together with another

      dock widget.

- QMessageBox

    * It is now possible to create categories in QErrorMessage to avoid error

      messages from the same category popping up repeatedly.

- QMetaObject

    * Added introspection of constructors, including the ability to invoke a

      constructor.

- QMetaProperty

    * [217531] Added the notifySignalIndex() function, which can be used to

      introspect which signal (if any) is emitted when a property is changed.

- QNetworkCookie

    * [206125] Added support for HTTP-only cookies.

- QNetworkProxyFactory

    * Added support for a factory of QNetworkProxy whose result can

      change depending on the connection being attempted.

    * Added support for querying system proxy settings on Mac OS X and

      Windows.

- QSharedPointer / QWeakPointer

    * Added two new classes for sharing pointers with support for atomic

      reference counting and custom destructors.

- QStringRef

  * [191369] Added QStringRef::localeAwareCompare() functions.

- QTabBar

    * Added the ability to place close buttons and widgets on tabs.

    * Added the ability to choose the selection behavior after a tab is

      removed.

    * Added a document mode which, on Mac OS X, paints the widget like

      Safari's tabs.

    * Added the movable property so that the user can move tabs easily.

    * Added mouse wheel support so that the mouse wheel can be used to change

      tabs.

- QTabWidget

    * Added a document mode that removes the tab widget border.

- QTcpSocket

    * [183743] Added support for requesting connections via proxies by

      hostname (no DNS resolution made on the client machine).

- QTextDocument / QTextDocumentWriter

    * Added the QTextDocumentWriter class which allows exporting of

      QTextDocument text and images to the OpenDocument format

      (ISO/IEC 26300).

- QtScriptTools

    * Added a new module to provide a debugger for Qt Script.

- Qt::WA_TranslucentBackground

    * Added this new window attribute to be able to have per-pixel

      translucency for top-level windows.

- Qt::WindowCloseButtonHint

    * Added a new window hint to control the visibility of the window close

      button.

- Qt::WindowStaysOnBottomHint

    * Added a new window hint to allow the window to stay below all other

      windows.

- Q_SIGNAL and Q_SLOT

    * Added new keywords to allow a single function to be marked as a signal

      or slot.

- QT4_IM_MODULE

    * [227849] Added a new environment variable that specifies the input

      method module to use and takes precedence over the QT_IM_MODULE

      enviroment variable. This environment variable allows the user to

      configure the environment to use different input methods for Qt 3 and

      Qt 4-based applications.

- QXmlQuery

    * Added a number of overloads to the bindVariable(), setFocus(), and

      evaluateTo() functions.

    * Added a property for controlling the network access manager.

    * Partial support for XSL-T has been added. See the main documentation for

      the QtXmlPatterns module for details.

Optimizations

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

- The backing store has been re-factored and optimized

    * Significant improvement in overall performance of painting for widgets.

    * Reduced the number of QRegion operations.

    * Improved update handling.

    * Improved the performance of clipping.

    * Support for full static contents.

- QGraphicsView has been optimized in several areas

    * Reduced the number of floating point operations.

    * Improved update handling.

    * Improved handling of deeply nested item trees.

    * Improved the performance of clipping for ItemClipChildrenToShape.

    * Improved sorting speed, so scenes with deeply nested item hierarchies do

      not affect the performance as compared to Qt 4.4.

- Widget style sheets optimisations

    * Improved the speed of style sheet initialization.

- QAbstractItemModel

    * Optimized QPersistantModelIndex creation and deletion.

    * Optimized adding and removing rows and columns.

- QFileSystemModel

    * Ensured that the model is always sorted when required.

- QTreeView

    * Optimized expanding and collapsing items.

    * Optimized expanding animations with large views.

- QRect and QRectF

    * Improves on functions like intersect(), contains(), etc.

- QTransform

    * Reduced the number of multiplications used for simple matrix types.

- QRasterPaintEngine

    * Reduced overhead of state changes; e.g., setPen() and setBrush().

    * Introduced a cache scheme for Windows glyphs, thus improving text

      drawing performance significantly.

    * Reduced the cost of doing rectangular clipping.

    * Improved pixmap drawing.

    * Improved pixmap scaling.

    * Optimized drawing of anti-aliased lines.

    * Optimized drawing of anti-aliased dashed lines.

Third party components

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

- Updated Qt's SQLite version to 3.5.9.

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

*                          Library                                         *

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

- General Fixes

    * [217988] Fixed a thread safety issue in QFontPrivate::engineForScript

      which could lead to buggy text rendering when rendering text from

      several threads.

    * [233703] Fixed a crash that occured when the input method (for example

      SCIM) was destroyed while the application is still running.

    * [233634] When there are several input method plugins available, they are

      now initialized only when the user switches to them.

    * [231089] Fixed an issue which caused HTTP GET to fail for chunk

      transfers.

    * [193475] Consumer tablet devices (like Wacom Graphite and Bamboo) now

      work on Windows and Mac OS X.

    * [203864] Do not warn when deleting objects in their event handler except

      for Qt Jambi.

- QAbstractItemModel

    * [233058] Fixed the sorting algorithm used in rowsRemoved().

- QAbstractItemView

    * [221955] Fixed a bug that allowed rows to be selected even if the

      selection mode was NoSelection.

    * [244716] Fixed a possible crash when an edited cell was moved.

    * [239642] Ensured that a rubber band selection is clear if the selection

      ends on the viewport.

    * [239121] Ensured that the old selection is clear when starting a

      selection on the viewport.

    * [219380] Fixed an update issue when removing rows.

- QAbstractSpinBox

    * [221221] Fixed a usability issue with QAbstractSpinBox subclasses in

      itemviews.

- QBitmap

    * [216648] Fixed a problem where QBitmaps were being converted to 32-bit

      QPixmaps when QPixmap::resize() was called.

- QByteArray and QString

    * [239351] Fixed a bug in QCharRef and QByteRef that would cause them to

      fail to detach properly in some cases. Applications need to be

      recompiled to use the fix.

    * [212140] Added repeated() functions to these classes.

    * [82509] Added QT_NO_CAST_FROM_BYTEARRAY to disable "operator const

      char *" and "operator const void *" in QByteArray.

- QCalendarWidget

    * [206017] Fixed minimumSize to be calculated correctly in the case where

      the vertical header has a different text format set.

    * [206282] Added support for browsing months using the mouse wheel.

    * [238384] A click on the date cell will now be ignored if the year

      spin box is opened.

- QCleanlooksStyle

    * [195446] Skip disabled menu and menu bar items when using keyboard

      navigation.

    * Fixed a problem with wrapped text eliding on titlebars.

    * [204269] Fixed a sizing problem with push buttons having mnemonics.

    * [216172] Fixed a problem with check box on inverted color schemes.

- QColor

    * [196704] Fixed a problem where the QColor::fromHsvF() function could

      return incorrect values.

- QComboBox

    * [167106] Fixed a problem where the combobox menu would incorrectly show

      check boxes after a style change.

    * [227080] Fixed handling of the style sheet background-color attribute on

      Windows.

    * [227080] Adjusted pop-up size when using style sheet border.

    * [238559] Fixed the completer as it was not using the right column with

      setModelColumn().

- QCommandLinkButton

    * [220475] Added support for On/Off icon states.

- QCommonStyle

    * [211489] Ensured that checkable group boxes with no title are drawn

      correctly.

    * [222561] Made more standard icons available.

- QCOMPARE(QtTest)

    * [183525] Fixed issue that caused QCOMPARE to give incomplete

      information when comparing two string lists.

    * [193456] Ensured that nmake install for QTestLib copies the DLL into the

      bin directory.

- QCoreApplication

    * [224233] Ensured that QCoreApplication::arguments() skips the

      -stylesheet argument.

- QDate

    * [222937] QDate - fixed issue preventing a minimum date of 01-01-01

      from being set.

- QDataStream

    * [230777] Fixed a bug that would cause skipRawBytes() to go

      backwards if the correct resulting position was larger than 2 GB.

- QDateTimeEdit

    * [196924] Improved QDateTimeEdit's usability. It now skips ahead to the

      next field when input can't be valid for the current section.

- QDBusConnection

    * [211797] Added support for the GetAll call in the standard

      org.freedesktop.DBus.Properties interface.

    * [229318] Fixed race conditions caused by timers being deleted in

      the wrong thread.

- QDesktopServices

    * [237398] Ensured that, on Mac OS X, returned paths do not have a

      trailing '/'.

- QDesktopWidget

    * [244004] Fixed a coordinate issue on Mac OS X with multi-screen setups

      where the screen sizes differ.

- QDialog

    * [214987] Ensured that maximize buttons are not put on dialogs by default

      on Mac OS X.

- QDialogButtonBox

    * [224781] Dialog buttons without icons now get the same height as dialog

      buttons with icons to maintain the alignment.

- QDockWidget

    * [237438] Fixed a crash in setFloat() for parentless dock widgets.

    * [204184] Subclasses are now allowed to handle mouse events.

    * [173854] Ensured that the size of the dock widget is remembered when it

      is hidden.

- QDomDocument

    * [212446] Ensured that a new line inserted after an element that

      indicates whitespace is preserved.

- QDomAttr

    * [226681] Fixed issue that caused specified() to return false if the

      attribute is specified in the XML.

- QEvent

    * Added more debug operators for common event types.

- QFlags

    * [221702] Fixed issue with testFlag() that gave a surprising result on

      enums with many bits.

- QFormLayout

    * [240759] Fixed crash in QFormLayout that could occur when a layout was

      alone in a row.

- QFile

    * [238027] Fixed a bug that would cause QFile not to be able to map a file

      to memory if QFile::open() was called with extra flags, like

      QIODevice::Unbuffered.

- QFileInfo

    * [166546] Fixed QFileInfo operator== bug involving trailing directory

      separators.

- QFileDialog

    * [240823] Fixed issues with file paths over 270 characters in length on

      Windows.

    * [212102] Fixed ".." directory issue.

    * [241213] Fixed some problems when renaming files.

    * [232613] Fixed a usability issue with UNC path on Windows.

    * [228844] Fixed a wrong insertion in the filesystemModel that caused

      persistant model index to be broken.

    * [190145] [203703] Fixed a bug in getExistingDirectory() that returned

      /home/ instead of /home, or on Windows, returned c:/temp/ instead of

      c:/temp. We now match the native behavior.

    * [236402] Fixed warning in the QFileDialog caused by deleting a directory

      we have previously visited.

    * [235069] Fixed issue that prevented QFileDialog from being closed on

      Escape when the list view had focus.

    * [233037] Fixed issue that caused the "Open" button to be disabled even

      if we want to enter a directory (in AcceptSave mode).

    * [223831] Ensured that the "Recent Places" string is translatable.

    * Fixed crash on Windows caused by typing \\\ (empty UNC Path).

    * [226366] Fixed issue that prevented the completer of the line edit from

      being shown when setting a directory with lower case letter.

    * [228158] Fixed issue that could cause the dialog to be closed when

      pressing Enter with a directory selected.

    * [231094] Fixed a hang that could occur when pressing a key.

    * [227304] Fixed a crash that could occur when the dialog had a completer

      and a QSortFilterProxyModel set.

    * [228566] Fixed the layout to avoid cyclically showing and hiding the

      scroll bars.

    * [206221] Ensured that the view is updated after editing a value with a

      custom editor.

    * [196561] Fixed the static API to return the path of the file instead of

      the link (.lnk) on Windows.

    * [239706] Fixed a crash that could occur when adding a name filter from

      an editable combo box.

    * [198193] Ensured that directory paths on Windows have a trailing

      backslash.

- QFrame

    * [215772] Style sheets: Ensured that the shape of the frame is respected

      when not styling the border.

- QFont

    * [223402] QFont's QDataStream operators will now save and restore the

      letter/word spacing.

- QFontMetrics

    * [225031] Fixed issue where QFontMetrics::averageCharWidth() could return

      0 on Mac OS X.

- QFtp

    * [227271] Added support for old FTP servers that do not recognize the

      "SIZE" and "MDTM" commands.

- QFuture

    * [214874] Fixed deadlock issue that could occur when cascading QFutures.

- QGLContext

    * [231613] Fixed a crash that could occur when trying to create a

      QGLContext without a valid paint device.

- QGLFramebufferObject

    * [236979] Fixed a problem with drawing to multiple, non-shared,

      QGLFramebufferObjects from the same thread using QPainter.

- QGraphicsEllipseItem

    * [207826] Fixed boundingRect() for spanAngle() != 360.

- QGraphicsGridLayout

    * [236367] Removed (0, 0) maximum size restriction of a QGraphicsItem by

      an empty QGridLayout.

- QGraphicsItem

    * [238655] Fixed slowdown in QGraphicsItem::collidesWithItem() that was

      present in Qt 4.4.

    * [198912] ItemClipsChildrenToShape now propagates to descendants.

    * [200229] Ensured that context menu events respect the

      ItemIgnoresTransformations flag.

    * Enabling ItemCoordinateCache with no default size now automatically

      resizes the item cache if the item's bounding rectangle changes.

    * [230312] Mac OS X: Fixed a bug where update() issued two paint events.

- QGraphicsLayout

    * [244402] Fixed issue that could cause a horizontal QGraphicsLinearLayout

      to stretch line edits vertically.

- QGraphicsLayoutItem

    * Fixed a crash that could occur with custom layouts which did not delete

      children.

- QGraphicsScene

    * [236127] Fixed BSP tree indexing error when setting the geometry of

      a QGraphicsWidget.

- QGraphicsWidget

    * [223403] Ensured that QGraphicsWidget(0, Qt::Popup) will close when you

      click outside it.

    * [236127] Fixed QGraphicsScene BSP tree indexing error.

    * Improved rendering of window title bars.

    * Fixed crash that could occur when a child that previously had the focus

      died without having the focus anymore.

- QGraphicsProxyWidget

    * [223616] Ensure that context menus triggered by ActionsContextMenu are

      embedded.

    * [227990] Widgets are not longer resized/moved when switching themes on

      Windows.

    * [219058] [237237] Fixed scroll artifacts in embedded widgets.

    * [236545] Ensured that the drag and drop cursor pixmap is not embedded

      into the scene on X11.

    * [238224] Fixed a crash that could occur when a proxy widget item was

      deleted.

    * [242553] Fixed drag and drop propagation for embedded widgets.

- QGraphicsSvgItem

    * [241475] Fixed update on geometry change.

- QGraphicsTextItem

    * [240400] Fixed bugs in mouse press handling.

    * [242331] Add tabChangesFocus() to let the user control whether the text

      item should process Tab input as a character, or just switch Tab focus.

- QGraphicsView

    * [236453] Improved Tab focus handling (propagate Tab and Backtab to items

      and widgets).

    * [239047] Improved stability of fitInView() with a very small viewport.

    * [242178] Fixed rubber band debris left in Windows XP style (potentially

      any style).

    * Fixed a crash in QGraphicsView resulting from the non-deletion of

      sub-proxy widgets.

    * Fixed issue that caused items() to return an incorrect list with an

      incorrect sort order when an item in the scene has the

      IgnoresTransformations flag set to true.

    * Ensured that the painter properly saves/restores its state after a call

      to drawBackground().

    * [197993] Allow any render hint to be set/cleared by the

      QGraphicsView::renderHints property.

    * [216741] Fixed handling of QGraphicsView::DontSavePainterState (broken

      in Qt 4.3).

    * [235101] [222323] [217819] [209977] Implemented proper font and palette

      propagation in Graphics View.

    * [238876] Fixed scroll artifacts in reverse mode.

    * [153586] Ensured that the text cursor is drawn correctly in transformed

      text controls in a QGraphicsView.

    * [224242] Added support for embedding nested graphics views.

- QGroupBox

    * [204823] Fixed a palette inconsistency when using certain styles.

- QHeaderView

    * [239684] Fixed sorting that wouldn't happen when clicking unless the

      sort indicator is shown.

    * [236907] Fixed bug that could cause hidden columns to become visible.

    * [215867] Resizing sections after moving sections could resize the wrong

      columns.

    * [211697] Fixed ResizeToContents to always show the full content of

      cells.

- QImage