From 0408dcd6a9d45e110610c6ed14987189d4e16c90 Mon Sep 17 00:00:00 2001 From: Chris Adams Date: Thu, 26 Jul 2012 10:51:50 +1000 Subject: [PATCH] Update whatsnew documentation with value-type improvements Value types are now supported as property types. QtQuick provides several new value types. Subproperty modification write-back semantics have been fixed for variant properties. Change-Id: Ic47a8401178e6f8bbd5037b6929d7afd5e3cffe6 Reviewed-by: Bea Lam --- src/qml/doc/src/whatsnew.qdoc | 9 ++++++-- src/quick/doc/src/whatsnew.qdoc | 46 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 2 deletions(-) diff --git a/src/qml/doc/src/whatsnew.qdoc b/src/qml/doc/src/whatsnew.qdoc index d66d78d..253c89c 100644 --- a/src/qml/doc/src/whatsnew.qdoc +++ b/src/qml/doc/src/whatsnew.qdoc @@ -71,8 +71,13 @@ has now been replaced by the new QtQml and QtQuick C++ modules. See the \li QML properties of type \l var and \l variant can now hold pixmaps. See \l {Scarce Resources in JavaScript} for more information. \li Value type improvements: \list - \li QColor is now a value type. The red, green, blue and alpha channels of a \l color property can be accessed via \c r, \c g, \c b and \c a properties. - \li Improved support for QVector4D, now constructible in QML via \c Qt.vector4d(). + \li QML now supports defining properties of value type basic types within QML documents. Supported types include + QSizeF, QPointF and QRectF as \c size, \c point and \c rect respectively. + \li QColor is now a value type provided by the QtQuick module. The red, green, blue and alpha channels + of a \l color property can be accessed via \c r, \c g, \c b and \c a properties. + \li Factory functions for various value types have been added to the \c Qt object exposed to QML. + Some of those functions require the QtQuick module to be imported in order to return valid values. + See the QtQuick 2.0 release notes for more information about these functions. \endlist \li Support for sequence types QList, QList, QList, QList, QList and QStringList has been improved. QObjects can define Q_PROPERTYs of diff --git a/src/quick/doc/src/whatsnew.qdoc b/src/quick/doc/src/whatsnew.qdoc index 8eff21e..4b6ea36 100644 --- a/src/quick/doc/src/whatsnew.qdoc +++ b/src/quick/doc/src/whatsnew.qdoc @@ -353,6 +353,52 @@ the window loses focus. \endlist \endlist +\section2 Property types + +Support for various math and geometry-related value types, including QVector2D, QVector3D, QVector4D, +QMatrix4x4 and QQuaternion, as well as QColor and QFont, are now provided by QtQuick. Properties of +these types can be declared in QML documents via the property syntax where the type name is \c vector2d, +\c vector3d, \c vector4d, \c matrix4x4, \c quaternion, \c color and \c font respectively. + +QtQuick also provides implementation for the various value type factory or utility functions of the +\c Qt object which return or operate on values of the above types. The functions are: +\table + \header + \li Value type + \li Functions + + \row + \li color + \li Qt.rgba(), Qt.hsla(), Qt.tint(), Qt.lighter(), Qt.darker(), Qt.colorEqual() + + \row + \li font + \li Qt.font(), Qt.fontFamilies() + + \row + \li vector2d + \li Qt.vector2d() + + \row + \li vector3d + \li Qt.vector3d() + + \row + \li vector4d + \li Qt.vector4d() + + \row + \li matrix4x4 + \li Qt.matrix4x4() + + \row + \li quaternion + \li Qt.quaternion() +\endtable + +The \c Qt.rgba(), \c Qt.hsla(), \c Qt.tint(), \c Qt.lighter(), \c Qt.darker() +and \c Qt.fontFamilies() functions already existed in \c QtDeclarative prior +to QtQuick 2.0; the other functions are all new in QtQuick 2.0. \section1 Qt 5.0 - Additional QML Modules -- 2.7.4