rhodes 5.5.0.3 → 5.5.0.7

data/platform/shared/qt/rhodes/qtscrollerproperties.h

@@ -0,0 +1,135 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef QTSCROLLERPROPERTIES_H
+#define QTSCROLLERPROPERTIES_H
+
+#include <QtCore/QScopedPointer>
+#include <QtCore/QMetaType>
+#include <QtCore/QVariant>
+
+#if (QT_VERSION < QT_VERSION_CHECK(4, 7, 0))
+#  include <QEasingCurve>
+Q_DECLARE_METATYPE(QEasingCurve)
+#endif
+
+class QtScroller;
+class QtScrollerPrivate;
+class QtScrollerPropertiesPrivate;
+
+class QtScrollerProperties
+{
+public:
+    QtScrollerProperties();
+    QtScrollerProperties(const QtScrollerProperties &sp);
+    QtScrollerProperties &operator=(const QtScrollerProperties &sp);
+    virtual ~QtScrollerProperties();
+
+    bool operator==(const QtScrollerProperties &sp) const;
+    bool operator!=(const QtScrollerProperties &sp) const;
+
+    static void setDefaultScrollerProperties(const QtScrollerProperties &sp);
+    static void unsetDefaultScrollerProperties();
+
+    enum OvershootPolicy
+    {
+        OvershootWhenScrollable,
+        OvershootAlwaysOff,
+        OvershootAlwaysOn
+    };
+
+    enum FrameRates {
+        Standard,
+        Fps60,
+        Fps30,
+        Fps20
+    };
+
+    enum ScrollMetric
+    {
+        MousePressEventDelay,                    // qreal [s]
+        DragStartDistance,                       // qreal [m]
+        DragVelocitySmoothingFactor,             // qreal [0..1/s]  (complex calculation involving time) v = v_new* DASF + v_old * (1-DASF)
+        AxisLockThreshold,                       // qreal [0..1] atan(|min(dx,dy)|/|max(dx,dy)|)
+
+        ScrollingCurve,                          // QEasingCurve
+        DecelerationFactor,                      // slope of the curve
+
+        MinimumVelocity,                         // qreal [m/s]
+        MaximumVelocity,                         // qreal [m/s]
+        MaximumClickThroughVelocity,             // qreal [m/s]
+
+        AcceleratingFlickMaximumTime,            // qreal [s]
+        AcceleratingFlickSpeedupFactor,          // qreal [1..]
+
+        SnapPositionRatio,                       // qreal [0..1]
+        SnapTime,                                // qreal [s]
+
+        OvershootDragResistanceFactor,           // qreal [0..1]
+        OvershootDragDistanceFactor,             // qreal [0..1]
+        OvershootScrollDistanceFactor,           // qreal [0..1]
+        OvershootScrollTime,                     // qreal [s]
+
+        HorizontalOvershootPolicy,               // enum OvershootPolicy
+        VerticalOvershootPolicy,                 // enum OvershootPolicy
+        FrameRate,                               // enum FrameRates
+
+        ScrollMetricCount
+    };
+
+    QVariant scrollMetric(ScrollMetric metric) const;
+    void setScrollMetric(ScrollMetric metric, const QVariant &value);
+
+protected:
+    QScopedPointer<QtScrollerPropertiesPrivate> d;
+
+private:
+    QtScrollerProperties(QtScrollerPropertiesPrivate &dd);
+
+    friend class QtScrollerPropertiesPrivate;
+    friend class QtScroller;
+    friend class QtScrollerPrivate;
+};
+
+Q_DECLARE_METATYPE(QtScrollerProperties::OvershootPolicy)
+Q_DECLARE_METATYPE(QtScrollerProperties::FrameRates)
+
+#endif // QTSCROLLERPROPERTIES_H

data/platform/shared/qt/rhodes/qtscrollerproperties_p.h

@@ -0,0 +1,90 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef QTSCROLLERPROPERTIES_P_H
+#define QTSCROLLERPROPERTIES_P_H
+
+//
+//  W A R N I N G
+//  -------------
+//
+// This file is not part of the Qt API.  It exists purely as an
+// implementation detail.  This header file may change from version to
+// version without notice, or even be removed.
+//
+// We mean it.
+//
+
+#include <QPointF>
+#include <QEasingCurve>
+#include "qtscrollerproperties.h"
+
+class QtScrollerPropertiesPrivate
+{
+public:
+    static QtScrollerPropertiesPrivate *defaults();
+
+    bool operator==(const QtScrollerPropertiesPrivate &) const;
+
+    qreal mousePressEventDelay;
+    qreal dragStartDistance;
+    qreal dragVelocitySmoothingFactor;
+    qreal axisLockThreshold;
+    QEasingCurve scrollingCurve;
+    qreal decelerationFactor;
+    qreal minimumVelocity;
+    qreal maximumVelocity;
+    qreal maximumClickThroughVelocity;
+    qreal acceleratingFlickMaximumTime;
+    qreal acceleratingFlickSpeedupFactor;
+    qreal snapPositionRatio;
+    qreal snapTime;
+    qreal overshootDragResistanceFactor;
+    qreal overshootDragDistanceFactor;
+    qreal overshootScrollDistanceFactor;
+    qreal overshootScrollTime;
+
+    QtScrollerProperties::OvershootPolicy hOvershootPolicy;
+    QtScrollerProperties::OvershootPolicy vOvershootPolicy;
+    QtScrollerProperties::FrameRates frameRate;
+};
+
+#endif // QTSCROLLERPROPERTIES_P_H

data/platform/shared/qt/rhodes/qtscrollevent.cpp

@@ -0,0 +1,190 @@
+#include <qtscrollevent.h>
+#include <qtscrollevent_p.h>
+
+/*!
+    \class QtScrollPrepareEvent
+    \since 4.8
+    \ingroup events
+
+    \brief The QtScrollPrepareEvent class is send in preparation of a scrolling.
+
+    The scroll prepare event is send before scrolling (usually by QtScroller) is started.
+    The object receiving this event should set viewportSize, maxContentPos and contentPos.
+    It also should accept this event to indicate that scrolling should be started.
+
+    It is not guaranteed that a QtScrollEvent will be send after an acceepted
+    QtScrollPrepareEvent, e.g. in a case where the maximum content position is (0,0).
+
+    \sa QScrollEvent, QScroller
+*/
+
+/*!
+    Creates new QScrollPrepareEvent
+    The \a startPos is the position of a touch or mouse event that started the scrolling.
+*/
+QtScrollPrepareEvent::QtScrollPrepareEvent(const QPointF &startPos)
+    : QEvent(static_cast<QEvent::Type>(ScrollPrepare)),
+      d(new QtScrollPrepareEventPrivate())
+{
+    d->startPos = startPos;
+}
+
+/*!
+    Destroys QtScrollPrepareEvent.
+*/
+QtScrollPrepareEvent::~QtScrollPrepareEvent()
+{
+}
+
+/*!
+    Returns the position of the touch or mouse event that started the scrolling.
+*/
+QPointF QtScrollPrepareEvent::startPos() const
+{
+    return d->startPos;
+}
+
+/*!
+    Returns size of the area that is to be scrolled as set by setViewportSize
+
+    \sa setViewportSize()
+*/
+QSizeF QtScrollPrepareEvent::viewportSize() const
+{
+    return d->viewportSize;
+}
+
+/*!
+    Returns maximum coordinates for the content as set by setMaximumContentRect.
+
+    \sa setMaximumContentRect()
+*/
+QRectF QtScrollPrepareEvent::contentPosRange() const
+{
+    return d->contentPosRange;
+}
+
+/*!
+    Returns the current position of the content as set by setContentPos.
+*/
+QPointF QtScrollPrepareEvent::contentPos() const
+{
+    return d->contentPos;
+}
+
+
+/*!
+    Sets the size of the area that is to be scrolled to \a size.
+
+    \sa viewportSize()
+*/
+void QtScrollPrepareEvent::setViewportSize(const QSizeF &size)
+{
+    d->viewportSize = size;
+}
+
+/*!
+    Sets the maximum content coordinates to \a rect.
+
+    \sa contentPosRange
+*/
+void QtScrollPrepareEvent::setContentPosRange(const QRectF &rect)
+{
+    d->contentPosRange = rect;
+}
+
+/*!
+    Sets the current content position to \a pos.
+
+    \sa contentPos()
+*/
+void QtScrollPrepareEvent::setContentPos(const QPointF &pos)
+{
+    d->contentPos = pos;
+}
+
+
+/*!
+    \class QtScrollEvent
+    \since 4.8
+    \ingroup events
+
+    \brief The QtScrollEvent class is send when scrolling.
+
+    The scroll event is send to indicate that the receiver should be scrolled.
+    Usually the receiver should be something visual like QWidget or QGraphicsObject.
+
+    Some care should be taken that no conflicting QtScrollEvents are sent from two
+    sources. Using QtScroller::scrollTo is safe however.
+
+    \sa QtScrollPrepareEvent, QtScroller
+*/
+
+/*!
+    \enum QtScrollEvent::ScrollStateFlag
+
+    This enum describes the states a scroll event can have.
+
+    \value ScrollStarted Set for the first scroll event of a scroll activity.
+
+    \value ScrollUpdated Set for all but the first and the last scroll event of a scroll activity.
+
+    \value ScrollFinished Set for the last scroll event of a scroll activity.
+
+    \sa QtScrollEvent::scrollState
+*/
+
+/*!
+    Creates a new QtScrollEvent
+    \a contentPos is the new content position, \a overshootDistance is the
+    new overshoot distance while \a scrollState indicates if this scroll
+    event is the first one, the last one or some event in between.
+*/
+QtScrollEvent::QtScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, ScrollState scrollState)
+    : QEvent(static_cast<QEvent::Type>(Scroll)),
+      d(new QtScrollEventPrivate())
+{
+    d->contentPos = contentPos;
+    d->overshoot= overshootDistance;
+    d->state = scrollState;
+}
+
+/*!
+    Destroys QtScrollEvent.
+*/
+QtScrollEvent::~QtScrollEvent()
+{
+}
+
+/*!
+    Returns the new scroll position.
+*/
+QPointF QtScrollEvent::contentPos() const
+{
+    return d->contentPos;
+}
+
+/*!
+    Returns the new overshoot distance.
+    See QtScroller for an explanation of the term overshoot.
+
+    \sa QtScroller
+*/
+QPointF QtScrollEvent::overshootDistance() const
+{
+    return d->overshoot;
+}
+
+/*!
+    Returns the current scroll state as a combination of ScrollStateFlag values.
+    ScrollStarted (or ScrollFinished) will be set, if this scroll event is the first (or last) event in a scrolling activity.
+    Please note that both values can be set at the same time, if the activity consists of a single QScrollEvent.
+    All other scroll events in between will have their state set to ScrollUpdated.
+
+    A widget could for example revert selections when scrolling is started and stopped.
+    \sa isLast()
+*/
+QtScrollEvent::ScrollState QtScrollEvent::scrollState() const
+{
+    return d->state;
+}

data/platform/shared/qt/rhodes/qtscrollevent.h

@@ -0,0 +1,100 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef QTSCROLLEVENT_H
+#define QTSCROLLEVENT_H
+
+#include <QEvent>
+#include <QPointF>
+#include <QSizeF>
+#include <QRectF>
+#include <QScopedPointer>
+
+
+class QtScrollPrepareEventPrivate;
+class QtScrollPrepareEvent : public QEvent
+{
+public:
+    enum { ScrollPrepare = 15056 }; // random number
+
+    QtScrollPrepareEvent(const QPointF &startPos);
+    ~QtScrollPrepareEvent();
+
+    QPointF startPos() const;
+
+    QSizeF viewportSize() const;
+    QRectF contentPosRange() const;
+    QPointF contentPos() const;
+
+    void setViewportSize(const QSizeF &size);
+    void setContentPosRange(const QRectF &rect);
+    void setContentPos(const QPointF &pos);
+
+private:
+    QScopedPointer<QtScrollPrepareEventPrivate> d;
+};
+
+
+class QtScrollEventPrivate;
+class QtScrollEvent : public QEvent
+{
+public:
+    enum { Scroll = 15057 }; // random number
+
+    enum ScrollState
+    {
+        ScrollStarted,
+        ScrollUpdated,
+        ScrollFinished
+    };
+
+    QtScrollEvent(const QPointF &contentPos, const QPointF &overshoot, ScrollState scrollState);
+    ~QtScrollEvent();
+
+    QPointF contentPos() const;
+    QPointF overshootDistance() const;
+    ScrollState scrollState() const;
+
+private:
+    QScopedPointer<QtScrollEventPrivate> d;
+};
+
+#endif // QTSCROLLEVENT_H