QTapAndHoldGestureRecognizer Class Reference

#include <qstandardgestures_p.h>

Inheritance diagram for QTapAndHoldGestureRecognizer:

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...
	QTapAndHoldGestureRecognizer ()
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 103 of file qstandardgestures_p.h.

Constructors and Destructors

QTapAndHoldGestureRecognizer()

QTapAndHoldGestureRecognizer::QTapAndHoldGestureRecognizer

(

)

Definition at line 490 of file qstandardgestures.cpp.

{
}

Functions

create()

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

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

recognize()

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

{
    QTapAndHoldGesture *q = static_cast<QTapAndHoldGesture *>(state);
    QTapAndHoldGesturePrivate *d = q->d_func();

    if (object == state && event->type() == QEvent::Timer) {
        q->killTimer(d->timerId);
        d->timerId = 0;
        return QGestureRecognizer::FinishGesture | QGestureRecognizer::ConsumeEventHint;
    }

    const QTouchEvent *ev = static_cast<const QTouchEvent *>(event);
    const QMouseEvent *me = static_cast<const QMouseEvent *>(event);
#ifndef QT_NO_GRAPHICSVIEW
    const QGraphicsSceneMouseEvent *gsme = static_cast<const QGraphicsSceneMouseEvent *>(event);
#endif

    enum { TapRadius = 40 };

    switch (event->type()) {
#ifndef QT_NO_GRAPHICSVIEW
    case QEvent::GraphicsSceneMousePress:
        d->position = gsme->screenPos();
        q->setHotSpot(d->position);
        if (d->timerId)
            q->killTimer(d->timerId);
        d->timerId = q->startTimer(QTapAndHoldGesturePrivate::Timeout);
        return QGestureRecognizer::MayBeGesture; // we don't show a sign of life until the timeout
#endif
    case QEvent::MouseButtonPress:
        d->position = me->globalPos();
        q->setHotSpot(d->position);
        if (d->timerId)
            q->killTimer(d->timerId);
        d->timerId = q->startTimer(QTapAndHoldGesturePrivate::Timeout);
        return QGestureRecognizer::MayBeGesture; // we don't show a sign of life until the timeout
    case QEvent::TouchBegin:
        d->position = ev->touchPoints().at(0).startScreenPos();
        q->setHotSpot(d->position);
        if (d->timerId)
            q->killTimer(d->timerId);
        d->timerId = q->startTimer(QTapAndHoldGesturePrivate::Timeout);
        return QGestureRecognizer::MayBeGesture; // we don't show a sign of life until the timeout
#ifndef QT_NO_GRAPHICSVIEW
    case QEvent::GraphicsSceneMouseRelease:
#endif
    case QEvent::MouseButtonRelease:
    case QEvent::TouchEnd:
        return QGestureRecognizer::CancelGesture; // get out of the MayBeGesture state
    case QEvent::TouchUpdate:
        if (d->timerId && ev->touchPoints().size() == 1) {
            QTouchEvent::TouchPoint p = ev->touchPoints().at(0);
            QPoint delta = p.pos().toPoint() - p.startPos().toPoint();
            if (delta.manhattanLength() <= TapRadius)
                return QGestureRecognizer::MayBeGesture;
        }
        return QGestureRecognizer::CancelGesture;
    case QEvent::MouseMove: {
        QPoint delta = me->globalPos() - d->position.toPoint();
        if (d->timerId && delta.manhattanLength() <= TapRadius)
            return QGestureRecognizer::MayBeGesture;
        return QGestureRecognizer::CancelGesture;
    }
#ifndef QT_NO_GRAPHICSVIEW
    case QEvent::GraphicsSceneMouseMove: {
        QPoint delta = gsme->screenPos() - d->position.toPoint();
        if (d->timerId && delta.manhattanLength() <= TapRadius)
            return QGestureRecognizer::MayBeGesture;
        return QGestureRecognizer::CancelGesture;
    }
#endif
    default:
        return QGestureRecognizer::Ignore;
    }
}

reset()

void QTapAndHoldGestureRecognizer::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 580 of file qstandardgestures.cpp.

{
    QTapAndHoldGesture *q = static_cast<QTapAndHoldGesture *>(state);
    QTapAndHoldGesturePrivate *d = q->d_func();

    d->position = QPointF();
    if (d->timerId)
        q->killTimer(d->timerId);
    d->timerId = 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