QPinchGestureRecognizer Class Reference

#include <qstandardgestures_p.h>

Inheritance diagram for QPinchGestureRecognizer:

Public Functions
QGesture *	create (QObject *target)
	This function is called by Qt to create a new QGesture object for the given target (QWidget or QGraphicsObject). More...
	QPinchGestureRecognizer ()
QGestureRecognizer::Result	recognize (QGesture *state, QObject *watched, QEvent *event)
	Handles the given event for the watched object, updating the state of the gesture object as required, and returns a suitable result for the current recognition step. More...
void	reset (QGesture *state)
	This function is called by the framework to reset a given gesture. More...
Public Functions inherited from QGestureRecognizer
	QGestureRecognizer ()
	Constructs a new gesture recognizer object. More...
virtual	~QGestureRecognizer ()
	Destroys the gesture recognizer. More...

Additional Inherited Members
Public Types inherited from QGestureRecognizer
enum	ResultFlag {   Ignore = 0x0001, MayBeGesture = 0x0002, TriggerGesture = 0x0004, FinishGesture = 0x0008,   CancelGesture = 0x0010, ResultState_Mask = 0x00ff, ConsumeEventHint = 0x0100, ResultHint_Mask = 0xff00 }
	This enum describes the result of the current event filtering step in a gesture recognizer state machine. More...
Static Public Functions inherited from QGestureRecognizer
static Qt::GestureType	registerRecognizer (QGestureRecognizer *recognizer)
	Registers the given recognizer in the gesture framework and returns a gesture ID for it. More...
static void	unregisterRecognizer (Qt::GestureType type)
	Unregisters all gesture recognizers of the specified type. More...

Detailed Description

Definition at line 73 of file qstandardgestures_p.h.

Constructors and Destructors

QPinchGestureRecognizer()

QPinchGestureRecognizer::QPinchGestureRecognizer

(

)

Definition at line 152 of file qstandardgestures.cpp.

{
}

Functions

create()

QGesture * QPinchGestureRecognizer::create ( QObject *  target )

virtual

This function is called by Qt to create a new QGesture object for the given target (QWidget or QGraphicsObject).

Reimplement this function to create a custom QGesture-derived gesture object if necessary.

The application takes ownership of the created gesture object.

Reimplemented from QGestureRecognizer.

Definition at line 156 of file qstandardgestures.cpp.

{
    if (target && target->isWidgetType()) {
        static_cast<QWidget *>(target)->setAttribute(Qt::WA_AcceptTouchEvents);
    }
    return new QPinchGesture;
}

recognize()

QGestureRecognizer::Result QPinchGestureRecognizer::recognize ( QGesture *  gesture, QObject *  watched, QEvent *  event  )

virtual

Handles the given event for the watched object, updating the state of the gesture object as required, and returns a suitable result for the current recognition step.

This function is called by the framework to allow the recognizer to filter input events dispatched to QWidget or QGraphicsObject instances that it is monitoring.

The result reflects how much of the gesture has been recognized. The state of the gesture object is set depending on the result.

See also

QGestureRecognizer::Result

Implements QGestureRecognizer.

Definition at line 164 of file qstandardgestures.cpp.

{
    QPinchGesture *q = static_cast<QPinchGesture *>(state);
    QPinchGesturePrivate *d = q->d_func();

    const QTouchEvent *ev = static_cast<const QTouchEvent *>(event);

    QGestureRecognizer::Result result;

    switch (event->type()) {
    case QEvent::TouchBegin: {
        result = QGestureRecognizer::MayBeGesture;
        break;
    }
    case QEvent::TouchEnd: {
        if (q->state() != Qt::NoGesture) {
            result = QGestureRecognizer::FinishGesture;
        } else {
            result = QGestureRecognizer::CancelGesture;
        }
        break;
    }
    case QEvent::TouchUpdate: {
        d->changeFlags = 0;
        if (ev->touchPoints().size() == 2) {
            QTouchEvent::TouchPoint p1 = ev->touchPoints().at(0);
            QTouchEvent::TouchPoint p2 = ev->touchPoints().at(1);

            d->hotSpot = p1.screenPos();
            d->isHotSpotSet = true;

            QPointF centerPoint = (p1.screenPos() + p2.screenPos()) / 2.0;
            if (d->isNewSequence) {
                d->startPosition[0] = p1.screenPos();
                d->startPosition[1] = p2.screenPos();
                d->lastCenterPoint = centerPoint;
            } else {
                d->lastCenterPoint = d->centerPoint;
            }
            d->centerPoint = centerPoint;

            d->changeFlags |= QPinchGesture::CenterPointChanged;

            if (d->isNewSequence) {
                d->scaleFactor = 1.0;
                d->lastScaleFactor = 1.0;
            } else {
                d->lastScaleFactor = d->scaleFactor;
                QLineF line(p1.screenPos(), p2.screenPos());
                QLineF lastLine(p1.lastScreenPos(),  p2.lastScreenPos());
                d->scaleFactor = line.length() / lastLine.length();
            }
            d->totalScaleFactor = d->totalScaleFactor * d->scaleFactor;
            d->changeFlags |= QPinchGesture::ScaleFactorChanged;

            qreal angle = QLineF(p1.screenPos(), p2.screenPos()).angle();
            if (angle > 180)
                angle -= 360;
            qreal startAngle = QLineF(p1.startScreenPos(), p2.startScreenPos()).angle();
            if (startAngle > 180)
                startAngle -= 360;
            const qreal rotationAngle = startAngle - angle;
            if (d->isNewSequence)
                d->lastRotationAngle = 0.0;
            else
                d->lastRotationAngle = d->rotationAngle;
            d->rotationAngle = rotationAngle;
            d->totalRotationAngle += d->rotationAngle - d->lastRotationAngle;
            d->changeFlags |= QPinchGesture::RotationAngleChanged;

            d->totalChangeFlags |= d->changeFlags;
            d->isNewSequence = false;
            result = QGestureRecognizer::TriggerGesture;
        } else {
            d->isNewSequence = true;
            if (q->state() == Qt::NoGesture)
                result = QGestureRecognizer::Ignore;
            else
                result = QGestureRecognizer::FinishGesture;
        }
        break;
    }
    case QEvent::MouseButtonPress:
    case QEvent::MouseMove:
    case QEvent::MouseButtonRelease:
        result = QGestureRecognizer::Ignore;
        break;
    default:
        result = QGestureRecognizer::Ignore;
        break;
    }
    return result;
}

reset()

void QPinchGestureRecognizer::reset ( QGesture *  gesture )

virtual

This function is called by the framework to reset a given gesture.

Reimplement this function to implement additional requirements for custom QGesture objects. This may be necessary if you implement a custom QGesture whose properties need special handling when the gesture is reset.

Reimplemented from QGestureRecognizer.

Definition at line 260 of file qstandardgestures.cpp.

{
    QPinchGesture *pinch = static_cast<QPinchGesture *>(state);
    QPinchGesturePrivate *d = pinch->d_func();

    d->totalChangeFlags = d->changeFlags = 0;

    d->startCenterPoint = d->lastCenterPoint = d->centerPoint = QPointF();
    d->totalScaleFactor = d->lastScaleFactor = d->scaleFactor = 1;
    d->totalRotationAngle = d->lastRotationAngle = d->rotationAngle = 0;

    d->isNewSequence = true;
    d->startPosition[0] = d->startPosition[1] = QPointF();

    QGestureRecognizer::reset(state);
}

---

The documentation for this class was generated from the following files:

• /src/gui/kernel/qstandardgestures_p.h
• /src/gui/kernel/qstandardgestures.cpp