Move QQuickHandlerPoint into its own header and cpp files

...in anticipation of needing it in QQuickMultiPointHandler.

Change-Id: Id98f2da34ee12b4cea3ba58550b446bfc989da1b
Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io>

1 files changed, 1 insertions, 210 deletions

diff --git a/src/quick/handlers/qquicksinglepointhandler.cpp b/src/quick/handlers/qquicksinglepointhandler.cpp
index 1a5537b732..5510813cce 100644
--- a/src/quick/handlers/qquicksinglepointhandler.cpp
+++ b/src/quick/handlers/qquicksinglepointhandler.cpp
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2017 The Qt Company Ltd.
+** Copyright (C) 2018 The Qt Company Ltd.
 ** Contact: https://www.qt.io/licensing/
 **
 ** This file is part of the QtQuick module of the Qt Toolkit.
@@ -264,213 +264,4 @@ void QQuickSinglePointHandler::reset()
     handled, this object is reset to default values (all coordinates are 0).
 */
 
-/*!
-    \qmltype HandlerPoint
-    \instantiates QQuickHandlerPoint
-    \inqmlmodule Qt.labs.handlers
-    \ingroup qtquick-handlers
-    \brief An event point
-
-    A QML representation of a QQuickEventPoint.
-
-    It's possible to make bindings to properties of a \l SinglePointHandler's
-    current point. For example:
-
-    \snippet pointerHandlers/dragHandlerNullTarget.qml 0
-
-    The point is kept up-to-date when the DragHandler is actively responding to
-    an EventPoint; but when the point is released, or the current point is
-    being handled by a different handler, \c position.x and \c position.y are 0.
-
-    \note This is practically identical to QtQuick::EventPoint; however an
-    EventPoint is a long-lived QObject which is invalidated between gestures
-    and reused for subsequent event deliveries. Continuous bindings to its
-    properties are not possible, and an individual handler cannot rely on it
-    outside the period when that point is part of an active gesture which that
-    handler is handling. HandlerPoint is a Q_GADGET that the handler owns.
-    This allows you to make lifetime bindings to its properties.
-
-    \sa SinglePointHandler::point
-*/
-
-QQuickHandlerPoint::QQuickHandlerPoint()
-    : m_id(0)
-    , m_rotation(0)
-    , m_pressure(0)
-{}
-
-void QQuickHandlerPoint::reset()
-{
-    m_id = 0;
-    m_uniqueId = QPointingDeviceUniqueId();
-    m_position = QPointF();
-    m_scenePosition = QPointF();
-    m_pressPosition = QPointF();
-    m_scenePressPosition = QPointF();
-    m_sceneGrabPosition = QPointF();
-    m_velocity = QVector2D();
-    m_rotation = 0;
-    m_pressure = 0;
-    m_ellipseDiameters = QSizeF();
-    m_pressedButtons = Qt::NoButton;
-}
-
-/*!
-    \readonly
-    \qmlproperty int QtQuick::HandlerPoint::id
-    \brief The ID number of the point
-
-    During a touch gesture, from the time that the first finger is pressed
-    until the last finger is released, each touchpoint will have a unique ID
-    number. Likewise, if input from multiple devices occurs (for example
-    simultaneous mouse and touch presses), all the current event points from
-    all the devices will have unique IDs.
-
-    \note Do not assume that id numbers start at zero or that they are
-    sequential. Such an assumption is often false due to the way the underlying
-    drivers work.
-
-    \sa QTouchEvent::TouchPoint::id
-*/
-
-/*!
-    \readonly
-    \qmlproperty PointingDeviceUniqueId QtQuick::HandlerPoint::uniqueId
-    \brief The unique ID of the point, if any
-
-    This is normally empty, because touchscreens cannot uniquely identify fingers.
-
-    On some types of touchscreens, especially those using TUIO drivers,
-    it's possible to use recognizable physical tokens (fiducial objects)
-    in addition to fingers.  So if this point is a touch point, and
-    uniqueId is set, it is the identifier for such an object.
-
-    On a graphics tablet, each type of stylus or other tool often has a unique
-    ID or serial number, which can be useful to respond in different ways to
-    different tools.
-
-    Interpreting the contents of this ID requires knowledge of the hardware and
-    drivers in use.
-
-    \sa QTabletEvent::uniqueId, QtQuick::TouchPoint::uniqueId, QtQuick::EventTouchPoint::uniqueId
-*/
-
-/*!
-    \readonly
-    \qmlproperty QPointF QtQuick::HandlerPoint::position
-    \brief The position within the \c parent Item
-
-    This is the position of the event point relative to the bounds of
-    the \l {PointerHandler::parent} {parent}.
-*/
-
-/*!
-    \readonly
-    \qmlproperty QPointF QtQuick::HandlerPoint::scenePosition
-    \brief The position within the scene
-
-    This is the position of the event point relative to the bounds of the Qt
-    Quick scene (typically the whole window).
-*/
-
-/*!
-    \readonly
-    \qmlproperty QPointF QtQuick::HandlerPoint::pressPosition
-    \brief The pressed position within the \c parent Item
-
-    This is the position at which this point was pressed, relative to the
-    bounds of the \l {PointerHandler::parent} {parent}.
-*/
-
-/*!
-    \readonly
-    \qmlproperty QPointF QtQuick::HandlerPoint::scenePressPosition
-    \brief The pressed position within the scene
-
-    This is the position at which this point was pressed, in the coordinate
-    system of the \l {Qt Quick Scene Graph}{scene graph}.
-*/
-
-/*!
-    \readonly
-    \qmlproperty QPointF QtQuick::HandlerPoint::sceneGrabPosition
-    \brief The grabbed position within the scene
-
-    If this point has been grabbed by a Pointer Handler or an Item, it means
-    that object has taken sole responsibility for handling the movement and the
-    release if this point. In that case, this is the position at which the grab
-    occurred, in the coordinate system of the \l {Qt Quick Scene Graph}{scene graph}.
-*/
-
-/*!
-    \readonly
-    \qmlproperty enum QtQuick::HandlerPoint::pressedButtons
-    \brief Which mouse or stylus buttons are currently pressed
-
-    \sa MouseArea::pressedButtons
-*/
-
-/*!
-    \readonly
-    \qmlproperty QVector2D QtQuick::HandlerPoint::velocity
-    \brief A vector representing the average speed and direction of movement
-
-    This is a velocity vector pointing in the direction of movement, in logical
-    pixels per second. It has x and y components, at least one of which will be
-    nonzero when this point is in motion. It holds the average recent velocity:
-    how fast and in which direction the event point has been moving recently.
-
-    \sa QtQuick::EventPoint::velocity, QtQuick::TouchPoint::velocity, QTouchEvent::TouchPoint::velocity
-*/
-
-/*!
-    \readonly
-    \qmlproperty qreal QtQuick::HandlerPoint::rotation
-
-    This property holds the rotation angle of the stylus on a graphics tablet
-    or the contact patch of a touchpoint on a touchscreen.
-
-    It is valid only with certain tablet stylus devices and touchscreens that
-    can measure the rotation angle. Otherwise, it will be zero.
-*/
-
-/*!
-    \readonly
-    \qmlproperty qreal QtQuick::HandlerPoint::pressure
-
-    This property tells how hard the user is pressing the stylus on a graphics
-    tablet or the finger against a touchscreen, in the range from \c 0 (no
-    measurable pressure) to \c 1.0 (maximum pressure which the device can
-    measure).
-
-    It is valid only with certain tablets and touchscreens that can measure
-    pressure. Otherwise, it will be zero.
-*/
-
-/*!
-    \readonly
-    \qmlproperty size QtQuick::HandlerPoint::ellipseDiameters
-
-    This property holds the diameters of the contact patch, if the event
-    comes from a touchpoint and the device provides this information.
-
-    A touchpoint is modeled as an elliptical area where the finger is pressed
-    against the touchscreen. (In fact, it could also be modeled as a bitmap;
-    but in that case we expect an elliptical bounding estimate to be fitted to
-    the contact patch before the event is sent.) The harder the user presses,
-    the larger the contact patch; so, these diameters provide an alternate way
-    of detecting pressure, in case the device does not include a separate
-    pressure sensor. The ellipse is centered on \l scenePosition (\l position
-    in the PointerHandler's Item's local coordinates). The \l rotation property
-    provides the rotation of the ellipse, if known. It is expected that if the
-    \l rotation is zero, the \l {QSize::height}{height} is the larger dimension
-    (the major axis), because of the usual hand position, reaching upward or
-    outward across the surface.
-
-    If the contact patch is unknown, or the device is not a touchscreen,
-    these values will be zero.
-
-    \sa QtQuick::EventTouchPoint::ellipseDiameters, QtQuick::TouchPoint::ellipseDiameters, QTouchEvent::TouchPoint::ellipseDiameters
-*/
-
 QT_END_NAMESPACE