QPanGestureRecognizer Class Reference

#include <qstandardgestures_p.h>

Inheritance diagram for QPanGestureRecognizer:

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...
	QPanGestureRecognizer ()
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 63 of file qstandardgestures_p.h.

Constructors and Destructors

QPanGestureRecognizer()

QPanGestureRecognizer::QPanGestureRecognizer

(

)

Definition at line 55 of file qstandardgestures.cpp.

{
}

Functions

create()

QGesture * QPanGestureRecognizer::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 59 of file qstandardgestures.cpp.

{
    if (target && target->isWidgetType()) {
#if defined(Q_OS_WIN) && !defined(QT_NO_NATIVE_GESTURES)
        // for scroll areas on Windows we want to use native gestures instead
        if (!qobject_cast<QAbstractScrollArea *>(target->parent()))
            static_cast<QWidget *>(target)->setAttribute(Qt::WA_AcceptTouchEvents);
#else
        static_cast<QWidget *>(target)->setAttribute(Qt::WA_AcceptTouchEvents);
#endif
    }
    return new QPanGesture;
}

recognize()

QGestureRecognizer::Result QPanGestureRecognizer::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 73 of file qstandardgestures.cpp.

{
    QPanGesture *q = static_cast<QPanGesture *>(state);
    QPanGesturePrivate *d = q->d_func();

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

    QGestureRecognizer::Result result;
    switch (event->type()) {
    case QEvent::TouchBegin: {
        result = QGestureRecognizer::MayBeGesture;
        QTouchEvent::TouchPoint p = ev->touchPoints().at(0);
        d->lastOffset = d->offset = QPointF();
        break;
    }
    case QEvent::TouchEnd: {
        if (q->state() != Qt::NoGesture) {
            if (ev->touchPoints().size() == 2) {
                QTouchEvent::TouchPoint p1 = ev->touchPoints().at(0);
                QTouchEvent::TouchPoint p2 = ev->touchPoints().at(1);
                d->lastOffset = d->offset;
                d->offset =
                        QPointF(p1.pos().x() - p1.startPos().x() + p2.pos().x() - p2.startPos().x(),
                              p1.pos().y() - p1.startPos().y() + p2.pos().y() - p2.startPos().y()) / 2;
            }
            result = QGestureRecognizer::FinishGesture;
        } else {
            result = QGestureRecognizer::CancelGesture;
        }
        break;
    }
    case QEvent::TouchUpdate: {
        if (ev->touchPoints().size() >= 2) {
            QTouchEvent::TouchPoint p1 = ev->touchPoints().at(0);
            QTouchEvent::TouchPoint p2 = ev->touchPoints().at(1);
            d->lastOffset = d->offset;
            d->offset =
                    QPointF(p1.pos().x() - p1.startPos().x() + p2.pos().x() - p2.startPos().x(),
                          p1.pos().y() - p1.startPos().y() + p2.pos().y() - p2.startPos().y()) / 2;
            if (d->offset.x() > 10  || d->offset.y() > 10 ||
                d->offset.x() < -10 || d->offset.y() < -10) {
                q->setHotSpot(p1.startScreenPos());
                result = QGestureRecognizer::TriggerGesture;
            } else {
                result = QGestureRecognizer::MayBeGesture;
            }
        }
        break;
    }
    case QEvent::MouseButtonPress:
    case QEvent::MouseMove:
    case QEvent::MouseButtonRelease:
        result = QGestureRecognizer::Ignore;
        break;
    default:
        result = QGestureRecognizer::Ignore;
        break;
    }
    return result;
}

reset()

void QPanGestureRecognizer::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 136 of file qstandardgestures.cpp.

{
    QPanGesture *pan = static_cast<QPanGesture*>(state);
    QPanGesturePrivate *d = pan->d_func();

    d->lastOffset = d->offset = QPointF();
    d->acceleration = 0;

    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