Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QML GestureArea Element

The GestureArea item enables simple gesture handling. More...

Inherits Item

- List of all members, including inherited members

## Detailed Description

A GestureArea is like a MouseArea, but it has signals for gesture events.

Warning: Elements in the Qt.labs module are not guaranteed to remain compatible in future versions.

Warning: GestureArea is an experimental element whose development has been discontinued. PinchArea is available in QtQuick 1.1 and handles two finger gesture input.

Note: This element is only functional on devices with touch input.

     import Qt.labs.gestures 1.0

     GestureArea {
         anchors.fill: parent
      // onPan:        ... gesture.acceleration ...
      // onPinch:      ... gesture.rotationAngle ...
      // onSwipe:      ...
      // onTapAndHold: ...
      // onTap:        ...
      // onGesture:    ...
     }

Each signal has a gesture parameter that has the properties of the gesture.

Signal | Type | Property | Description
--- | --- | --- | ---
onTap | point | position | the position of the tap
onTapAndHold | point | position | the position of the tap
onPan | real | acceleration | the acceleration of the pan
onPan | point | delta | the offset from the previous input position to the current input
onPan | point | offset | the total offset from the first input position to the current input position
onPan | point | lastOffset | the previous value of offset
onPinch | point | centerPoint | the midpoint between the two input points
onPinch | point | lastCenterPoint | the previous value of centerPoint
onPinch | point | startCenterPoint | the first value of centerPoint
onPinch | real | rotationAngle | the angle covered by the gesture motion
onPinch | real | lastRotationAngle | the previous value of rotationAngle
onPinch | real | totalRotationAngle | the complete angle covered by the gesture
onPinch | real | scaleFactor | the change in distance between the two input points
onPinch | real | lastScaleFactor | the previous value of scaleFactor
onPinch | real | totalScaleFactor | the complete scale factor of the gesture
onSwipe | real | swipeAngle | the angle of the swipe

Custom gestures, handled by onGesture, will have custom properties.

GestureArea is an invisible item: it is never painted.

See also MouseArea.