From 8ebe8f6eeb798918486e1e9124a567dd90deff23 Mon Sep 17 00:00:00 2001
From: Shawn Rutledge <shawn.rutledge@qt.io>
Date: Fri, 22 Sep 2017 14:09:45 +0200
Subject: improve documentation of PinchHandler
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The readonly properties were omitted until now.

Change-Id: Ia4f4b8ff5a390f6e802008c9c636d7d8ab2a3278
Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io>
---
 src/quick/handlers/qquickpinchhandler.cpp | 48 +++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/src/quick/handlers/qquickpinchhandler.cpp b/src/quick/handlers/qquickpinchhandler.cpp
index 3cd99fe1a2..eb544ff169 100644
--- a/src/quick/handlers/qquickpinchhandler.cpp
+++ b/src/quick/handlers/qquickpinchhandler.cpp
@@ -55,6 +55,7 @@ Q_LOGGING_CATEGORY(lcPinchHandler, "qt.quick.handler.pinch")
 /*!
     \qmltype PinchHandler
     \instantiates QQuickPinchHandler
+    \inherits MultiPointHandler
     \inqmlmodule Qt.labs.handlers
     \ingroup qtquick-handlers
     \brief Handler for pinch gestures
@@ -374,4 +375,51 @@ void QQuickPinchHandler::handlePointerEventImpl(QQuickPointerEvent *event)
     emit updated();
 }
 
+/*!
+    \readonly
+    \qmlproperty QPointF QtQuick::PinchHandler::centroid
+
+    A point exactly in the middle of the currently-pressed touch points.
+    If \l pinchOrigin is set to \c PinchCenter, the \l target will be rotated
+    around this point.
+*/
+
+/*!
+    \readonly
+    \qmlproperty QVector2D QtQuick::PinchHandler::centroidVelocity
+
+    The average velocity of the \l centroid: a vector representing the speed
+    and direction of movement of the whole group of touchpoints, in logical
+    pixels per second.
+*/
+
+/*!
+    \readonly
+    \qmlproperty real QtQuick::PinchHandler::scale
+
+    The scale factor. It is 1.0 when the gesture begins, increases as the
+    touchpoints are spread apart, and decreases as the touchpoints are brought
+    together. If \l target is not null, this will be automatically applied to its
+    \l {Item::scale}{scale}. Otherwise, bindings can be used to do arbitrary
+    things with this value.
+*/
+
+/*!
+    \readonly
+    \qmlproperty real QtQuick::PinchHandler::rotation
+
+    The rotation of the pinch gesture in degrees, with positive values clockwise.
+    It is 0 when the gesture begins. If \l target is not null, this will be
+    automatically applied to its \l {Item::rotation}{rotation}. Otherwise,
+    bindings can be used to do arbitrary things with this value.
+*/
+
+/*!
+    \readonly
+    \qmlproperty QVector2D QtQuick::PinchHandler::translation
+
+    The translation of the gesture \l centroid. It is \c (0, 0) when the
+    gesture begins.
+*/
+
 QT_END_NAMESPACE
-- 
cgit v1.2.3