uTouch-qml 1.0
A QML plugin for the uTouch gesture stack
UTouchDragArea Class Reference

An input-only item for receiving non-instantaneous drag gesture events. More...

Inherits ContinuousGestureArea.

List of all members.

Signals

void onGestureStart (GestureEvent gesture)
 This handler is called when a gesture starts.
void onGestureUpdate (GestureEvent gesture)
 This handler is called when a gesture is updated.
void onGestureEnd (GestureEvent gesture)
 This handler is called when a gesture ends.

Properties

bool active
 This property denotes whether the gesture is currently active.
Gesture subscription
 This property holds the subscription for the item.
bool enabled
 This property holds whether the item accepts gesture events.
GestureProperty centroid
 This property holds the position of the centroid of the touches comprising the gesture.
point focus
 This property holds the focus point of the gesture.

Detailed Description

An input-only item for receiving non-instantaneous drag gesture events.


Member Function Documentation

void ContinuousGestureArea::onGestureEnd ( GestureEvent  gesture) [signal, inherited]

This handler is called when a gesture ends.

The gesture parameter provides information about the gesture.

The accepted property of the GestureEvent parameter is ignored in this handler.

void ContinuousGestureArea::onGestureStart ( GestureEvent  gesture) [signal, inherited]

This handler is called when a gesture starts.

The gesture parameter provides information about the gesture.

If the accepted property of the GestureEvent parameter is set to false in the handler, the gesture is rejected and no further signals will be emitted for the gesture. The accepted property defaults to true.

void ContinuousGestureArea::onGestureUpdate ( GestureEvent  gesture) [signal, inherited]

This handler is called when a gesture is updated.

The gesture parameter provides information about the gesture.

The accepted property of the GestureEvent parameter is ignored in this handler.


Property Documentation

bool ContinuousGestureArea::active [read, inherited]

This property denotes whether the gesture is currently active.

The value is set to true after onGestureStart is emitted, and set to false before onGestureEnd is emitted.

GestureProperty GestureArea::centroid [read, inherited]

This property holds the position of the centroid of the touches comprising the gesture.

For TouchScreen devices, the centroid is mapped to item coordinates. For all other devices, the centroid is left in device coordinates.

bool GestureArea::enabled [read, write, inherited]

This property holds whether the item accepts gesture events.

By default, this property is true.

point GestureArea::focus [read, inherited]

This property holds the focus point of the gesture.

For TouchScreen devices, the focus point is the centroid of the touches when the gesture begins. For other devices, the focus point is the location of the pointer when the gesture begins.

The focus point is always mapped to item coordinates.

Gesture GestureArea::subscription [read, inherited]

This property holds the subscription for the item.

When the subscription is modified, the old subscription is deleted and a new subscription is created.