Flickable: add horizontal/verticalOvershoot properties

[ChangeLog][QtQuick][Flickable] Added horizontalOvershoot and
verticalOvershoot properties that can be used for implementing
boundary actions and effects.

Task-number: QTBUG-38515
Change-Id: I06379348a67d03507b56788d6fc7020bbb2d375f
Reviewed-by: Robin Burchell <robin.burchell@viroteck.net>

1 files changed, 196 insertions, 0 deletions

diff --git a/tests/auto/quick/qquickflickable/tst_qquickflickable.cpp b/tests/auto/quick/qquickflickable/tst_qquickflickable.cpp
index 942e99018f..1ad691d1c1 100644
--- a/tests/auto/quick/qquickflickable/tst_qquickflickable.cpp
+++ b/tests/auto/quick/qquickflickable/tst_qquickflickable.cpp
@@ -95,6 +95,9 @@ private slots:
     void ratios_smallContent();
     void contentXYNotTruncatedToInt();
     void keepGrab();
+    void overshoot();
+    void overshoot_data();
+    void overshoot_reentrant();
 
 private:
     void flickWithTouch(QQuickWindow *window, QTouchDevice *touchDevice, const QPoint &from, const QPoint &to);
@@ -2037,6 +2040,199 @@ void tst_qquickflickable::keepGrab()
     QVERIFY(flickable->contentY() != 0.0);
 }
 
+Q_DECLARE_METATYPE(QQuickFlickable::BoundsBehavior)
+
+void tst_qquickflickable::overshoot()
+{
+    QFETCH(QQuickFlickable::BoundsBehavior, boundsBehavior);
+
+    QScopedPointer<QQuickView> window(new QQuickView);
+    window->setSource(testFileUrl("overshoot.qml"));
+    window->show();
+
+    QVERIFY(QTest::qWaitForWindowExposed(window.data()));
+
+    QQuickFlickable *flickable = qobject_cast<QQuickFlickable*>(window->rootObject());
+    QVERIFY(flickable);
+
+    QCOMPARE(flickable->width(), 200.0);
+    QCOMPARE(flickable->height(), 200.0);
+    QCOMPARE(flickable->contentWidth(), 400.0);
+    QCOMPARE(flickable->contentHeight(), 400.0);
+
+    flickable->setBoundsBehavior(boundsBehavior);
+
+    // drag past the beginning
+    QTest::mousePress(window.data(), Qt::LeftButton, 0, QPoint(10, 10));
+    QTest::mouseMove(window.data(), QPoint(20, 20));
+    QTest::mouseMove(window.data(), QPoint(30, 30));
+    QTest::mouseMove(window.data(), QPoint(40, 40));
+    QTest::mouseRelease(window.data(), Qt::LeftButton, 0, QPoint(50, 50));
+
+    if (boundsBehavior & QQuickFlickable::DragOverBounds) {
+        QVERIFY(flickable->property("minVerticalOvershoot").toReal() < 0.0);
+        QVERIFY(flickable->property("minHorizontalOvershoot").toReal() < 0.0);
+        QCOMPARE(flickable->property("minContentY").toReal(),
+                 flickable->property("minVerticalOvershoot").toReal());
+        QCOMPARE(flickable->property("minContentX").toReal(),
+                 flickable->property("minHorizontalOvershoot").toReal());
+    } else {
+        QCOMPARE(flickable->property("minContentY").toReal(), 0.0);
+        QCOMPARE(flickable->property("minContentX").toReal(), 0.0);
+        QCOMPARE(flickable->property("minVerticalOvershoot").toReal(), 0.0);
+        QCOMPARE(flickable->property("minHorizontalOvershoot").toReal(), 0.0);
+    }
+    QCOMPARE(flickable->property("maxContentY").toReal(), 0.0);
+    QCOMPARE(flickable->property("maxContentX").toReal(), 0.0);
+    QCOMPARE(flickable->property("maxVerticalOvershoot").toReal(), 0.0);
+    QCOMPARE(flickable->property("maxHorizontalOvershoot").toReal(), 0.0);
+
+    flickable->setContentX(20.0);
+    flickable->setContentY(20.0);
+    QMetaObject::invokeMethod(flickable, "reset");
+
+    // flick past the beginning
+    flick(window.data(), QPoint(10, 10), QPoint(50, 50), 100);
+    QTRY_VERIFY(!flickable->property("flicking").toBool());
+
+    if (boundsBehavior & QQuickFlickable::OvershootBounds) {
+        QVERIFY(flickable->property("minVerticalOvershoot").toReal() < 0.0);
+        QVERIFY(flickable->property("minHorizontalOvershoot").toReal() < 0.0);
+        QCOMPARE(flickable->property("minContentY").toReal(),
+                 flickable->property("minVerticalOvershoot").toReal());
+        QCOMPARE(flickable->property("minContentX").toReal(),
+                 flickable->property("minHorizontalOvershoot").toReal());
+    } else {
+        QCOMPARE(flickable->property("minContentY").toReal(), 0.0);
+        QCOMPARE(flickable->property("minContentX").toReal(), 0.0);
+        QCOMPARE(flickable->property("minVerticalOvershoot").toReal(), 0.0);
+        QCOMPARE(flickable->property("minHorizontalOvershoot").toReal(), 0.0);
+    }
+    QCOMPARE(flickable->property("maxContentY").toReal(), 20.0);
+    QCOMPARE(flickable->property("maxContentX").toReal(), 20.0);
+    QCOMPARE(flickable->property("maxVerticalOvershoot").toReal(), 0.0);
+    QCOMPARE(flickable->property("maxHorizontalOvershoot").toReal(), 0.0);
+
+    flickable->setContentX(200.0);
+    flickable->setContentY(200.0);
+    QMetaObject::invokeMethod(flickable, "reset");
+
+    // drag past the end
+    QTest::mousePress(window.data(), Qt::LeftButton, 0, QPoint(50, 50));
+    QTest::mouseMove(window.data(), QPoint(40, 40));
+    QTest::mouseMove(window.data(), QPoint(30, 30));
+    QTest::mouseMove(window.data(), QPoint(20, 20));
+    QTest::mouseRelease(window.data(), Qt::LeftButton, 0, QPoint(10, 10));
+
+    if (boundsBehavior & QQuickFlickable::DragOverBounds) {
+        QVERIFY(flickable->property("maxVerticalOvershoot").toReal() > 0.0);
+        QVERIFY(flickable->property("maxHorizontalOvershoot").toReal() > 0.0);
+        QCOMPARE(flickable->property("maxContentY").toReal() - 200.0,
+                 flickable->property("maxVerticalOvershoot").toReal());
+        QCOMPARE(flickable->property("maxContentX").toReal() - 200.0,
+                 flickable->property("maxHorizontalOvershoot").toReal());
+    } else {
+        QCOMPARE(flickable->property("maxContentY").toReal(), 200.0);
+        QCOMPARE(flickable->property("maxContentX").toReal(), 200.0);
+        QCOMPARE(flickable->property("maxVerticalOvershoot").toReal(), 0.0);
+        QCOMPARE(flickable->property("maxHorizontalOvershoot").toReal(), 0.0);
+    }
+    QCOMPARE(flickable->property("minContentY").toReal(), 200.0);
+    QCOMPARE(flickable->property("minContentX").toReal(), 200.0);
+    QCOMPARE(flickable->property("minVerticalOvershoot").toReal(), 0.0);
+    QCOMPARE(flickable->property("minHorizontalOvershoot").toReal(), 0.0);
+
+    flickable->setContentX(180.0);
+    flickable->setContentY(180.0);
+    QMetaObject::invokeMethod(flickable, "reset");
+
+    // flick past the end
+    flick(window.data(), QPoint(50, 50), QPoint(10, 10), 100);
+    QTRY_VERIFY(!flickable->property("flicking").toBool());
+
+    if (boundsBehavior & QQuickFlickable::OvershootBounds) {
+        QVERIFY(flickable->property("maxVerticalOvershoot").toReal() > 0.0);
+        QVERIFY(flickable->property("maxHorizontalOvershoot").toReal() > 0.0);
+        QCOMPARE(flickable->property("maxContentY").toReal() - 200.0,
+                 flickable->property("maxVerticalOvershoot").toReal());
+        QCOMPARE(flickable->property("maxContentX").toReal() - 200.0,
+                 flickable->property("maxHorizontalOvershoot").toReal());
+    } else {
+        QCOMPARE(flickable->property("maxContentY").toReal(), 200.0);
+        QCOMPARE(flickable->property("maxContentX").toReal(), 200.0);
+        QCOMPARE(flickable->property("maxVerticalOvershoot").toReal(), 0.0);
+        QCOMPARE(flickable->property("maxHorizontalOvershoot").toReal(), 0.0);
+    }
+    QCOMPARE(flickable->property("minContentY").toReal(), 180.0);
+    QCOMPARE(flickable->property("minContentX").toReal(), 180.0);
+    QCOMPARE(flickable->property("minVerticalOvershoot").toReal(), 0.0);
+    QCOMPARE(flickable->property("minHorizontalOvershoot").toReal(), 0.0);
+}
+
+void tst_qquickflickable::overshoot_data()
+{
+    QTest::addColumn<QQuickFlickable::BoundsBehavior>("boundsBehavior");
+
+    QTest::newRow("StopAtBounds")
+            << QQuickFlickable::BoundsBehavior(QQuickFlickable::StopAtBounds);
+    QTest::newRow("DragOverBounds")
+            << QQuickFlickable::BoundsBehavior(QQuickFlickable::DragOverBounds);
+    QTest::newRow("OvershootBounds")
+            << QQuickFlickable::BoundsBehavior(QQuickFlickable::OvershootBounds);
+    QTest::newRow("DragAndOvershootBounds")
+            << QQuickFlickable::BoundsBehavior(QQuickFlickable::DragAndOvershootBounds);
+}
+
+void tst_qquickflickable::overshoot_reentrant()
+{
+    QScopedPointer<QQuickView> window(new QQuickView);
+    window->setSource(testFileUrl("overshoot_reentrant.qml"));
+    window->show();
+
+    QVERIFY(QTest::qWaitForWindowExposed(window.data()));
+
+    QQuickFlickable *flickable = qobject_cast<QQuickFlickable*>(window->rootObject());
+    QVERIFY(flickable);
+
+    // horizontal
+    flickable->setContentX(-10.0);
+    QCOMPARE(flickable->contentX(), -10.0);
+    QCOMPARE(flickable->horizontalOvershoot(), -10.0);
+
+    flickable->setProperty("contentPosAdjustment", -5.0);
+    flickable->setContentX(-20.0);
+    QCOMPARE(flickable->contentX(), -25.0);
+    QCOMPARE(flickable->horizontalOvershoot(), -25.0);
+
+    flickable->setContentX(210);
+    QCOMPARE(flickable->contentX(), 210.0);
+    QCOMPARE(flickable->horizontalOvershoot(), 10.0);
+
+    flickable->setProperty("contentPosAdjustment", 5.0);
+    flickable->setContentX(220.0);
+    QCOMPARE(flickable->contentX(), 225.0);
+    QCOMPARE(flickable->horizontalOvershoot(), 25.0);
+
+    // vertical
+    flickable->setContentY(-10.0);
+    QCOMPARE(flickable->contentY(), -10.0);
+    QCOMPARE(flickable->verticalOvershoot(), -10.0);
+
+    flickable->setProperty("contentPosAdjustment", -5.0);
+    flickable->setContentY(-20.0);
+    QCOMPARE(flickable->contentY(), -25.0);
+    QCOMPARE(flickable->verticalOvershoot(), -25.0);
+
+    flickable->setContentY(210);
+    QCOMPARE(flickable->contentY(), 210.0);
+    QCOMPARE(flickable->verticalOvershoot(), 10.0);
+
+    flickable->setProperty("contentPosAdjustment", 5.0);
+    flickable->setContentY(220.0);
+    QCOMPARE(flickable->contentY(), 225.0);
+    QCOMPARE(flickable->verticalOvershoot(), 25.0);
+}
+
 QTEST_MAIN(tst_qquickflickable)
 
 #include "tst_qquickflickable.moc"