QTapGestureRecognizer Class Reference

#include <qstandardgestures_p.h>

Inheritance diagram for QTapGestureRecognizer:

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...
	QTapGestureRecognizer ()
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 93 of file qstandardgestures_p.h.

Constructors and Destructors

QTapGestureRecognizer()

QTapGestureRecognizer::QTapGestureRecognizer

(

)

Definition at line 419 of file qstandardgestures.cpp.

{
}

Functions

create()

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

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

recognize()

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

{
    QTapGesture *q = static_cast<QTapGesture *>(state);
    QTapGesturePrivate *d = q->d_func();

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

    QGestureRecognizer::Result result = QGestureRecognizer::CancelGesture;

    switch (event->type()) {
    case QEvent::TouchBegin: {
        d->position = ev->touchPoints().at(0).pos();
        q->setHotSpot(ev->touchPoints().at(0).screenPos());
        result = QGestureRecognizer::TriggerGesture;
        break;
    }
    case QEvent::TouchUpdate:
    case QEvent::TouchEnd: {
        if (q->state() != Qt::NoGesture && ev->touchPoints().size() == 1) {
            QTouchEvent::TouchPoint p = ev->touchPoints().at(0);
            QPoint delta = p.pos().toPoint() - p.startPos().toPoint();
            enum { TapRadius = 40 };
            if (delta.manhattanLength() <= TapRadius) {
                if (event->type() == QEvent::TouchEnd)
                    result = QGestureRecognizer::FinishGesture;
                else
                    result = QGestureRecognizer::TriggerGesture;
            }
        }
        break;
    }
    case QEvent::MouseButtonPress:
    case QEvent::MouseMove:
    case QEvent::MouseButtonRelease:
        result = QGestureRecognizer::Ignore;
        break;
    default:
        result = QGestureRecognizer::Ignore;
        break;
    }
    return result;
}

reset()

void QTapGestureRecognizer::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 476 of file qstandardgestures.cpp.

{
    QTapGesture *q = static_cast<QTapGesture *>(state);
    QTapGesturePrivate *d = q->d_func();

    d->position = 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