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

over the 4.5.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.6

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

Applications compiled for 4.5 will continue to run with 4.6.

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

corresponding to tasks in the Qt Bug Tracker, the (now obsolete) Task

Tracker, or the Merge Request queue of the public source repository.

Qt Bug Tracker: http://bugreports.qt.nokia.com

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

Merge Request: http://qt.gitorious.org

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

*                           General                                        *

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

New features

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

 - QState, QStateMachine

    * New classes for state machine framework added to QtCore.

 - QAbstractAnimation

    * New animation framework added to QtCore

 - QTouchEvent

    * New class for handling multitouch events added to QtGui

 - QGesture, QGestureRecognizer

    * New gesture framework added to QtGui

 - QMatrix4x4, QGenericMatrix, QVector2D, QVector3D, QVector4D, QQuaternion

    * New classes to support 3D applications.

 - QGLShaderProgram, QGLShader

    * New classes for using shader programs written in the GL Shading Language.

 - QGraphicsEffect

    * New classes for applying graphics effects to graphics items and widgets.

 - QWebElement

    * New class for DOM access added to QtWebKit

 - QAudioInput, QAudioOutput

    * New audio input and output classes.

 - QAbstractVideoSurface, QVideoFrame

    * New abstract video output classes.

 - OpenVG graphics system added.

 - Added 800x480 screen mode to qvfb configuration dialog.

 - Improved support for input methods in graphics view.

 - [MR#1742] Added new multimedia keys to the Qt::Key enum.

 - Boxes demo ported to use new 3D math and shader program classes.

 - QtTest now supports outputting XUnit XML documents, for integrating

   with existing continuous integration systems. This is enabled by

   running the test program with the -xunitxml option.

 - QtDBus

   * The minimum required version of the D-Bus reference library is

     now 0.93.

   * Support for reading and writing of custom property types added.

   * Support for getting return arguments in remote method invocation

     via QMetaMethod::invokeMethod.

 - The QtScript module is now based on the 3rdparty JavaScriptCore library. It

   is only available under the LGPL or a compatible license.

Optimizations

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

 - Optimized rendering strategy in QGraphicsView

    * See list of Important Behavior Changes below

 - Improved delivery of posted events on Windows

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

*                          Library                                         *

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

QtCore

------

 - QAbstractItemModel

    * [MR#972] Added API to move items

    * [MR#1072] Added function beginResetModel() / endResetModel()

 - QByteArray

    * New overloads for QByteArray::insert() and QByteArray::prepend().

    * [MR#1286] Added value_type typedef for STL compatibility

 - QEventDispatcherGlib (internal class)

    * Fix a regression introduced in 4.5.3 that would cause timers to not

      be delivered.

 - QEventDispatcherUNIX (internal class)

    * Improve detection of monotonic clock support to include

      non-POSIX.1-2001 compliant systems.

    * [250681] Fix time change detection on UNIX systems without monotonic

      timers.

 - QEventDispatcherWin32 (internal class)

    * Changed the threshold for using multimedia timers to 20ms (was 10ms).

    * Changed the way Qt's posted events are sent by the event

      dispatcher. They are now driven on top of a Windows message

      instead of an explicit call in processEvents(). This means that

      posted events are sent even when a Windows modal message loop is

      running (for example, when the user is moving a window or when a

      native modal dialog is visible).

    * Fixed a bug that would allow the same timer id to be used by multiple

      QTimer instances.

 - QFile

    * Make QFile::resize() more robust when operating on buffered files.

 - QObject

    * [259514] fixed a possible dead-lock in the destructor.

    * Added the possibility to pass the flag Qt::UniqueConnection to

      QObject::connect.

    * Fixed race conditions that occured when moving object to threads

      while connecting.

 - QPluginLoader

    * Improved performance of plugin loading by reusing the plugin cache

      instead of loading it every time.

 - QProcessEnvironment

    * New class; support for easy access to key/value pairs in the process

      environment.

 - QRegExp

    * New pattern syntax "QRegExp::WildcardUnix" with wildcard character

      escaping.

 - QScopedPointer

    * New pointer class for cleaning up objects when leaving the current

      scope.

 - QSharedPointer

    * Added support for creating the object along with the internal private

      data in one single memory allocation. (QSharedPointer::create)

    * Fixed a bug where, in a race condition, QSharedPointer could track a

      pointer that was being deleted.

 - QTextCodec

    * Instantiate the CP949 codec when building with -no-iconv.

 - QTextStream

    * [221316] Fixed crash on large input.

    * Improved reading utf8/utf16/utf32 data by correctly skipping the

      ByteOrderMark when reading data by one character at a time.

 - QThread

    * [249997] Document that QThread priority has no effect on Linux.

 - QUrl

    * Made QUrl hostname parser a lot stricter, requiring compliance

      to STD3 to validate, thus preventing invalid hostnames from

      being accepted. See below in "Important Behavior Changes".

 - QUuid

    * [QTBUG-3543] Fixed a bug in createUuid() which caused multiple

      threads to generate the identical UUID sequences.

 - QVariant

    * Many optimisations.

    * Added QVariant::toFloat() and QVariant::toReal().

    * Added QVariant(float) constructor.

    * qvariant_cast<QVariant> and qVariantFromValue<QVariant> are now

      identity functions.

    * Added support for math3d types.

 - QWeakPointer

    * Added support for tracking QObject-derived classes that aren't

      attached to a QSharedPointer.

    * Added QWeakPointer::data which allows you to obtain the pointer

      being tracked (without protection).

    * Added operator-> like the above data(), but requires a #define.

 - QXmlStreamWriter

    * [256468] Fixed comment indentation.

QtGui

-----

 - Qt::escape

    * Now escape the double quote (").

 - QAbstractItemView

    * [256502] Fixes selectionModel::hasSelection return value after

      model::reset.

    * [MR#1426] Fixes some issues with Shift-selection

    * [MR#1668] New QAbstractItemView::setDefaultDropAction

 - QApplication

    * [QTBUG-739] Removed internal widgets from QApplication::topLevelWidgets().

 - QCalendarWidget

    * [252943] QCalendarWidget::setDateTextFormat() reset the format if the

      date is invalid.

 - QColumnView

    * [246999] Fixed view not updating when the model changed dynamically.

 - QComboBox

    * [220195] Fixed keyboard search when current index is -1.

 - QCompleter

    * [246056] Fixed a possible assertion when setting the completer prefix.

 - QEvent

    * Introduced RequestSoftwareInputPanel and CloseSoftwareInputPanel events.

 - QFontDialog

    * [256466] Fixed the dialog not always returning the selected style.

 - QFontEngine

    * [QTBUG-2354] Support certain 'Microsoft' platform symbol fonts which

      also contain a regular unicode table for exactly the symbol range of

      code points.

 - QFontEngineQPF

    * Make alphaMapForGlyph() generate the correct color table for

      Indexed8 and Mono glyph images.  Fixed the "all glyphs are white

      boxes" problem in OpenGL1 paint engine.

 - QFontMetrics

    * [176401] Account for right bearing in bounding rect.

 - QGraphicsAnchorLayout

    * Support for expanding size policy has been removed. (The Qt 4.6 Beta

      had support for it).

 - QGraphicsBlurEffect

    * Since the 4.6 Beta, Qt::RenderHint has been moved to

      QGraphicsBlurEffect::BlurHint.

    * Input contexts are not activated for disabled widgets anymore.

    * [250555] Data copied from Mozilla Firefox can now be pasted correctly to

      a Qt application.

 - QGraphicsItem

    * Many optimizations.

    * Fixed bug and improved accuracy of QGraphicsItem::childrenBoundingRect().

    * Introduced QGraphicsItem::ItemHasNoContents.

    * Introduced QGraphicsItem::ItemSendsGeometryChanges (see Behavioral

      Changes).

    * Introduced QGraphicsItem::focusProxy(), focus proxy support.

    * Introduced QGraphicsItem::ItemNegativeZStacksBehindParent.

    * Introduced QGraphicsItem::ItemIsPanel, light-weight window support.

    * Introduced modality support for QGraphicsItem panels.

    * Introduced activation support.

    * Introduced QGraphicsItem::stackBefore().

    * Cached items are now always invalidated when update() is called.

    * Added input hints.

    * Added a new set of properties to set a transformation on an item.

 - QGraphicsLayout

    * Introduced QGraphicsLayout::addChildLayoutItem().

 - QGraphicsObject

    * New class; inherits QGraphicsItem and adds notification signals and

      property declarations.

 - QGraphicsProxyWidget

    * [251407] Fixed window flag handling. Now QGraphicsProxyWidget's flags

      win.

    * Fix Qt::ClickFocus policy.

 - QGraphicsScene

    * Many optimizations.

    * [245317] Fixes to mouse grabbing behavior.

    * Fixed delivery of double-click events after explicit grab and then ungrab.

    * Rewrote the internal rendering to use a recursive instead of an iterative

      approach.

    * Ensure hover enter events are delivered when an item is pressed.

    * Introduced activation support.

    * Fixed bugs in initial focus support.

 - QGraphicsTextItem

    * Now inherits from QGraphicsObject instead.

 - QGraphicsTransform

    * New class; eases animation of transformations for QGraphicsItem.

 - QGraphicsView

    * Many optimizations.

    * Fix mapToScene(QRect) to avoid extra unnecessary adjustments.

    * Introduced QGraphicsView::isTransformed().

    * [QTBUG-4151] Items with parent that sets ItemClipsChildrenToShape were

      sometimes invisible.

 - QGraphicsWidget

    * Now inherits from QGraphicsObject instead.

    * Interactive resizing of top level windows now respects height-for-width

      constraints.

    * Reduced memory footprint.

 - QHeaderView

    * [208320] Make sure the sort indicator is taken into account for the size

      hint.

    * [255574] Make sure the size hint for the section depends on visible

      sections.

 - QImageReader

    * [255627] Fix floating point exception in

      QImageReader::setScaledSize(QSize(0, 0)).

 - QLineEdit

    * [248948] Clear selection when redoing a delete operation.

    * [QTBUG-5261] Fixed bug where erasing characters from a textedit did not

      update the text.

 - QListView

    * [243335] Fixed the visualRect to return correct values when the widget is

      not yet shown.

    * [MR#666] Fixed selection with Shift-Arrow/Shift-Click in QListView's IconMode

 - QMainWindow

    * [226060] Adding actions to a toolbar would always make the next toolbar

      move.

 - QMenu

    * [252610] Fixed position of the shortcut text while setting a stylesheet

      on menu items

 - QMenuBar

    * [260873] Fix mouse interaction while undocking a widget from the main

      window

    * Dock areas didn't get a splitter if their dock widgets were not

      resizable.

 - QPaintDevice

    * New qt_paint_device_metric() function to replace the friend declarations

      for window surface classes that need to access metric().

 - QPainter

    * [QTBUG-1666] Made QPainter::drawText() respect Qt::TextDontClip flag

      also in vertical direction.

    * [254658] Improved clipping performance in OpenGL paint engine.

 - QPainterPath

    * [QTBUG-1537] Fixed bug where the points of a rounded rectangle were added

      in counter-clockwise order instead of clockwise order like other shapes.

 - QPen

    * [QTBUG-2738] Made QPen::setDashOffset() work with non-custom dashed lines.

 - QPixmap

    * Optimized width(), height(), isNull() and depth().

    * [QTBUG-2832] Fixed bug where calling fill on pixmap with active painter

      could crash.

 - QPlainTextEdit

    * Fixed crash when clicking on a text edit which was smaller than the

      height of the font used.

 - QPlastiqueStyle

    * [QTBUG-3555] Fixed a bug in the Plastique style that would cause an

      ASSERT failure in QFont when the application font has a pixel size set.

 - QPrinter

    * [QTBUG-4497] Removed redundant SetPen command in the postscript code when

      reusing a QPrinter object.

 - QPrintPreviewDialog now uses a QMainWindow with a proper QToolBar, instead

   of a plain layout.

 - QPushButton

    * [255581] Fixed sizeHint recalculation bug.

 - QRasterPaintEngine

    * [QTBUG-4210] Fixed bug where bitmaps were painted black instead of in pen

      colour.

 - QRegion

    * Minor optimizations.

 - QSortFilterProxyModel

    * [251296] Fixed bugs in which filtered items could not be filtered.

 - QSplitter

    * [206494] Added ability to style pressed slider with stylesheet.

 - QSpinBox

    * [259226] Fixed setting a stylesheet on a QSpinBox to change the arrow

      position.

    * [255051] Fixed sizeHint update bug.

 - QStandardItemModel

    * [255652] Fixed crash while using takeRow with a QSortFilterProxyModel.

 - QStroker

    * [QTBUG-5212] Fixed bug where thick strokes around small shapes could

      cause holes in the stroke.

 - QTabBar

    * [196326] Fixed having a stylesheet on a QTabBar resulted in some tab

      names being slightly clipped.

    * [241383] Added ability to style the close tab button with style sheet

 - QTableView

    * [191545] Selections work more similarly to well-known spreadsheets.

    * [234926] Fixed sorting after changing QTableView header.

    * [244651] [245327] [250193] [QTBUG-5062] Spans get plenty of love with

      performance improvements, support for row/column insertioa and removal,

      and better keyboard navigation.

 - QTableWidget

    * [234641] Fixed takeItem to cause the view to be updated.

 - QTextDocument

    * [207189] Support setting font size using short hand syntax in the

      CSS "font" property.

    * [201228] Remove implicit margin on bullet lists when exporting to HTML.

    * [240086] Fixed bug which caused floating objects which span several

      pages to float into the second page of the document even when it's

      the only existing object, causing the document to contain a blank

      first page.

    * [240325] Even with wrap mode set to Qt::TextWordWrap, the layout

      would sometimes break outside word boundaries when floating objects

      affected the width available to the text.

    * [MR#681] Added support for roman numbering for lists

    * [MR#1753] Fixed escaping HTML attributes QTextDocument::toHtml()

 - QTextLayout

    * [QTBUG-4468] Count tabs as multiple characters when applying a fixed

      column width.

    * [176401] Take into account the negative right bearing of the last

      character in an item of text if the glyph extends beyond its ascent.

 - QToolTip

    * Fixed a bug where tooltips were not shown in popups (Windows only).

 - QTreeView

    * [234930] Be able to use :has-children and :has-sibillings in a stylesheet.

    * [252616] Set QStyleOptionViewItemV4::OnlyOne flag when painting spanning

      columns.

    * [245654] Fixed expandAll when deleting and recreating a mode for the tree.

    * [239271] Fixed missing update when adding a row when the first column is

      hidden.

    * [258225] Fixed scrollTo with center and bottom.

 - QTreeWidget

    * [253109] Shows the widget when calling setItemWidget.

    * [MR#1393] Use stable sorting.

 - QWidget

    * Added inputMethodHints property.

    * [201649] Added QWidget::previousInFocusChain.

    * [254563] Fixed a crash when setting focus in a widget tree that

      contains invisible widgets.

    * [QTBUG-5012] Fixed uninitialized background when using QWidget::render

      with Qt::WA_NoSystemBackground and window opacity set.

QtDBus

------

 - QDBusConnection

    * Made sending of invalid/incomplete messages consistently fail with error

      (no more assertions).

    * [249528/QTBUG-3833] Added an overload of connect() that allows one to

      specify strings for matching arguments.

 - QDBusServiceWatcher

    * New class; supports efficiently watching for a service to be created,

      deleted or to change owners.

QtNetwork

---------

 - QAbstractSocket

    * Only disconnect from host when all bytes have been written.

    * New setSocketOption method.

 - QHttp

    * Do not buffer the complete POST data anymore when HTTPS is used.

    * QHttp is now obsolete and replaced by QNetworkAccessManager.

 - QLocalServer

    * Fix timeout when waiting for a connection on Unix.

 - QNativeSocketEngine

    * Do not set the OS socket send and receive buffer size. The OS

      should auto tune these values for us.