57 |
57 |
58 Gesture objects are not constructed directly by developers. They are created by |
58 Gesture objects are not constructed directly by developers. They are created by |
59 the QGestureRecognizer object that is registered with the application; see |
59 the QGestureRecognizer object that is registered with the application; see |
60 QGestureRecognizer::registerRecognizer(). |
60 QGestureRecognizer::registerRecognizer(). |
61 |
61 |
|
62 For an overview of gesture handling in Qt and information on using gestures |
|
63 in your applications, see the \l{Gestures Programming} document. |
|
64 |
62 \section1 Gesture Properties |
65 \section1 Gesture Properties |
63 |
66 |
64 The class has a list of properties that can be queried by the user to get |
67 The class has a list of properties that can be queried by the user to get |
65 some gesture-specific arguments. For example, the pinch gesture has a scale |
68 some gesture-specific arguments. For example, the pinch gesture has a scale |
66 factor that is exposed as a property. |
69 factor that is exposed as a property. |
217 \brief The QPanGesture class describes a panning gesture made by the user. |
220 \brief The QPanGesture class describes a panning gesture made by the user. |
218 \ingroup gestures |
221 \ingroup gestures |
219 |
222 |
220 \image pangesture.png |
223 \image pangesture.png |
221 |
224 |
222 \sa {Gestures Programming}, QPinchGesture, QSwipeGesture |
225 For an overview of gesture handling in Qt and information on using gestures |
|
226 in your applications, see the \l{Gestures Programming} document. |
|
227 |
|
228 \sa QPinchGesture, QSwipeGesture |
223 */ |
229 */ |
224 |
230 |
225 /*! |
231 /*! |
226 \property QPanGesture::lastOffset |
232 \property QPanGesture::lastOffset |
227 \brief the last offset recorded for this gesture |
233 \brief the last offset recorded for this gesture |
304 |
310 |
305 /*! |
311 /*! |
306 \class QPinchGesture |
312 \class QPinchGesture |
307 \since 4.6 |
313 \since 4.6 |
308 \brief The QPinchGesture class describes a pinch gesture made my the user. |
314 \brief The QPinchGesture class describes a pinch gesture made my the user. |
309 \ingroup multitouch |
315 \ingroup touch |
310 \ingroup gestures |
316 \ingroup gestures |
311 |
317 |
312 A pinch gesture is a form of multitouch user input in which the user typically |
318 A pinch gesture is a form of touch user input in which the user typically |
313 touches two points on the input device with a thumb and finger, before moving |
319 touches two points on the input device with a thumb and finger, before moving |
314 them closer together or further apart to change the scale factor, zoom, or level |
320 them closer together or further apart to change the scale factor, zoom, or level |
315 of detail of the user interface. |
321 of detail of the user interface. |
|
322 |
|
323 For an overview of gesture handling in Qt and information on using gestures |
|
324 in your applications, see the \l{Gestures Programming} document. |
316 |
325 |
317 \image pinchgesture.png |
326 \image pinchgesture.png |
318 |
327 |
319 Instead of repeatedly applying the same pinching gesture, the user may |
328 Instead of repeatedly applying the same pinching gesture, the user may |
320 continue to touch the input device in one place, and apply a second touch |
329 continue to touch the input device in one place, and apply a second touch |
321 to a new point, continuing the gesture. When this occurs, gesture events |
330 to a new point, continuing the gesture. When this occurs, gesture events |
322 will continue to be delivered to the target object, containing an instance |
331 will continue to be delivered to the target object, containing an instance |
323 of QPinchGesture in the Qt::GestureUpdated state. |
332 of QPinchGesture in the Qt::GestureUpdated state. |
324 |
333 |
325 \sa {Gestures Programming}, QPanGesture, QSwipeGesture |
334 \sa QPanGesture, QSwipeGesture |
326 */ |
335 */ |
327 |
336 |
328 /*! |
337 /*! |
329 \enum QPinchGesture::ChangeFlag |
338 \enum QPinchGesture::ChangeFlag |
330 |
339 |
387 /*! |
396 /*! |
388 \property QPinchGesture::scaleFactor |
397 \property QPinchGesture::scaleFactor |
389 \brief the current scale factor |
398 \brief the current scale factor |
390 |
399 |
391 The scale factor measures the scale factor associated with the distance |
400 The scale factor measures the scale factor associated with the distance |
392 between two of the user's inputs on a multitouch device. |
401 between two of the user's inputs on a touch device. |
393 |
402 |
394 \sa totalScaleFactor, lastScaleFactor |
403 \sa totalScaleFactor, lastScaleFactor |
395 */ |
404 */ |
396 |
405 |
397 /*! |
406 /*! |
570 \brief The QSwipeGesture class describes a swipe gesture made by the user. |
579 \brief The QSwipeGesture class describes a swipe gesture made by the user. |
571 \ingroup gestures |
580 \ingroup gestures |
572 |
581 |
573 \image swipegesture.png |
582 \image swipegesture.png |
574 |
583 |
575 \sa {Gestures Programming}, QPanGesture, QPinchGesture |
584 For an overview of gesture handling in Qt and information on using gestures |
|
585 in your applications, see the \l{Gestures Programming} document. |
|
586 |
|
587 \sa QPanGesture, QPinchGesture |
576 */ |
588 */ |
577 |
589 |
578 /*! |
590 /*! |
579 \enum QSwipeGesture::SwipeDirection |
591 \enum QSwipeGesture::SwipeDirection |
580 |
592 |
665 \class QTapGesture |
677 \class QTapGesture |
666 \since 4.6 |
678 \since 4.6 |
667 \brief The QTapGesture class describes a tap gesture made by the user. |
679 \brief The QTapGesture class describes a tap gesture made by the user. |
668 \ingroup gestures |
680 \ingroup gestures |
669 |
681 |
670 \sa {Gestures Programming}, QPanGesture, QPinchGesture |
682 For an overview of gesture handling in Qt and information on using gestures |
|
683 in your applications, see the \l{Gestures Programming} document. |
|
684 |
|
685 \sa QPanGesture, QPinchGesture |
671 */ |
686 */ |
672 |
687 |
673 /*! |
688 /*! |
674 \property QTapGesture::position |
689 \property QTapGesture::position |
675 \brief the position of the tap |
690 \brief the position of the tap |
698 \since 4.6 |
713 \since 4.6 |
699 \brief The QTapAndHoldGesture class describes a tap-and-hold (aka LongTap) |
714 \brief The QTapAndHoldGesture class describes a tap-and-hold (aka LongTap) |
700 gesture made by the user. |
715 gesture made by the user. |
701 \ingroup gestures |
716 \ingroup gestures |
702 |
717 |
703 \sa {Gestures Programming}, QPanGesture, QPinchGesture |
718 For an overview of gesture handling in Qt and information on using gestures |
|
719 in your applications, see the \l{Gestures Programming} document. |
|
720 |
|
721 \sa QPanGesture, QPinchGesture |
704 */ |
722 */ |
705 |
723 |
706 /*! |
724 /*! |
707 \property QTapAndHoldGesture::position |
725 \property QTapAndHoldGesture::position |
708 \brief the position of the tap |
726 \brief the position of the tap |