Qt 4.8
|
The QPinchGesture class describes a pinch gesture made by the user. More...
#include <qgesture.h>
Public Types | |
enum | ChangeFlag { ScaleFactorChanged = 0x1, RotationAngleChanged = 0x2, CenterPointChanged = 0x4 } |
This enum describes the changes that can occur to the properties of the gesture object. More... | |
Public Types inherited from QGesture | |
enum | GestureCancelPolicy { CancelNone = 0, CancelAllInContext } |
This enum describes how accepting a gesture can cancel other gestures automatically. More... | |
Public Functions | |
QPointF | centerPoint () const |
ChangeFlags | changeFlags () const |
QPointF | lastCenterPoint () const |
qreal | lastRotationAngle () const |
qreal | lastScaleFactor () const |
QPinchGesture (QObject *parent=0) | |
qreal | rotationAngle () const |
qreal | scaleFactor () const |
void | setCenterPoint (const QPointF &value) |
void | setChangeFlags (ChangeFlags value) |
void | setLastCenterPoint (const QPointF &value) |
void | setLastRotationAngle (qreal value) |
void | setLastScaleFactor (qreal value) |
void | setRotationAngle (qreal value) |
void | setScaleFactor (qreal value) |
void | setStartCenterPoint (const QPointF &value) |
void | setTotalChangeFlags (ChangeFlags value) |
void | setTotalRotationAngle (qreal value) |
void | setTotalScaleFactor (qreal value) |
QPointF | startCenterPoint () const |
ChangeFlags | totalChangeFlags () const |
qreal | totalRotationAngle () const |
qreal | totalScaleFactor () const |
Public Functions inherited from QGesture | |
GestureCancelPolicy | gestureCancelPolicy () const |
Qt::GestureType | gestureType () const |
bool | hasHotSpot () const |
QPointF | hotSpot () const |
QGesture (QObject *parent=0) | |
Constructs a new gesture object with the given parent. More... | |
void | setGestureCancelPolicy (GestureCancelPolicy policy) |
void | setHotSpot (const QPointF &value) |
Qt::GestureState | state () const |
void | unsetHotSpot () |
~QGesture () | |
Destroys the gesture object. More... | |
Public Functions inherited from QObject | |
bool | blockSignals (bool b) |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
const QObjectList & | children () const |
Returns a list of child objects. More... | |
bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
bool | disconnect (const QObject *receiver, const char *member=0) |
void | dumpObjectInfo () |
Dumps information about signal connections, etc. More... | |
void | dumpObjectTree () |
Dumps a tree of children to the debug output. More... | |
QList< QByteArray > | dynamicPropertyNames () const |
Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
virtual bool | event (QEvent *) |
This virtual function receives events to an object and should return true if the event e was recognized and processed. More... | |
virtual bool | eventFilter (QObject *, QEvent *) |
Filters events if this object has been installed as an event filter for the watched object. More... | |
template<typename T > | |
T | findChild (const QString &aName=QString()) const |
Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
template<typename T > | |
QList< T > | findChildren (const QString &aName=QString()) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
template<typename T > | |
QList< T > | findChildren (const QRegExp &re) const |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
void | installEventFilter (QObject *) |
Installs an event filter filterObj on this object. More... | |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false. More... | |
void | killTimer (int id) |
Kills the timer with timer identifier, id. More... | |
virtual const QMetaObject * | metaObject () const |
Returns a pointer to the meta-object of this object. More... | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. More... | |
QString | objectName () const |
QObject * | parent () const |
Returns a pointer to the parent object. More... | |
QVariant | property (const char *name) const |
Returns the value of the object's name property. More... | |
Q_INVOKABLE | QObject (QObject *parent=0) |
Constructs an object with parent object parent. More... | |
void | removeEventFilter (QObject *) |
Removes an event filter object obj from this object. More... | |
void | setObjectName (const QString &name) |
void | setParent (QObject *) |
Makes the object a child of parent. More... | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. More... | |
void | setUserData (uint id, QObjectUserData *data) |
bool | signalsBlocked () const |
Returns true if signals are blocked; otherwise returns false. More... | |
int | startTimer (int interval) |
Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
QThread * | thread () const |
Returns the thread in which the object lives. More... | |
QObjectUserData * | userData (uint id) const |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. More... | |
Public Variables | |
QPointF | centerPoint |
the current center point More... | |
ChangeFlags | changeFlags |
the property of the gesture that has changed in the current step More... | |
QPointF | lastCenterPoint |
the last position of the center point recorded for this gesture More... | |
qreal | lastRotationAngle |
the last reported angle covered by the gesture motion More... | |
qreal | lastScaleFactor |
the last scale factor recorded for this gesture More... | |
qreal | rotationAngle |
the angle covered by the gesture motion More... | |
qreal | scaleFactor |
the current scale factor More... | |
QPointF | startCenterPoint |
the starting position of the center point More... | |
ChangeFlags | totalChangeFlags |
the property of the gesture that has change More... | |
qreal | totalRotationAngle |
the total angle covered by the gesture More... | |
qreal | totalScaleFactor |
the total scale factor More... | |
Friends | |
class | QPinchGestureRecognizer |
Additional Inherited Members | |
Public Slots inherited from QObject | |
void | deleteLater () |
Schedules this object for deletion. More... | |
Signals inherited from QObject | |
void | destroyed (QObject *=0) |
This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Static Public Functions inherited from QObject | |
static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
Disconnects signal in object sender from method in object receiver. More... | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static uint | registerUserData () |
static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
Static Public Variables inherited from QObject | |
static const QMetaObject | staticMetaObject |
This variable stores the meta-object for the class. More... | |
Protected Functions inherited from QGesture | |
QGesture (QGesturePrivate &dd, QObject *parent) | |
Protected Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *) |
This event handler can be reimplemented in a subclass to receive child events. More... | |
virtual void | connectNotify (const char *signal) |
This virtual function is called when something has been connected to signal in this object. More... | |
virtual void | customEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive custom events. More... | |
virtual void | disconnectNotify (const char *signal) |
This virtual function is called when something has been disconnected from signal in this object. More... | |
QObject (QObjectPrivate &dd, QObject *parent=0) | |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. More... | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *) |
This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
Protected Variables inherited from QObject | |
QScopedPointer< QObjectData > | d_ptr |
Static Protected Variables inherited from QObject | |
static const QMetaObject | staticQtMetaObject |
Related Functions inherited from QObject | |
T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
T * | qobject_cast (QObject *object) |
QObjectList | |
void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
Returns a pointer to the object named name that inherits type and with a given parent. More... | |
The QPinchGesture class describes a pinch gesture made by the user.
A pinch gesture is a form of touch user input in which the user typically touches two points on the input device with a thumb and finger, before moving them closer together or further apart to change the scale factor, zoom, or level of detail of the user interface.
For an overview of gesture handling in Qt and information on using gestures in your applications, see the Gestures Programming document.
Instead of repeatedly applying the same pinching gesture, the user may continue to touch the input device in one place, and apply a second touch to a new point, continuing the gesture. When this occurs, gesture events will continue to be delivered to the target object, containing an instance of QPinchGesture in the Qt::GestureUpdated state.
Definition at line 136 of file qgesture.h.
This enum describes the changes that can occur to the properties of the gesture object.
Enumerator | |
---|---|
ScaleFactorChanged | |
RotationAngleChanged | |
CenterPointChanged |
Definition at line 143 of file qgesture.h.
QPinchGesture::QPinchGesture | ( | QObject * | parent = 0 | ) |
Definition at line 560 of file qgesture.cpp.
QPointF QPinchGesture::centerPoint | ( | ) | const |
Referenced by setChangeFlags().
ChangeFlags QPinchGesture::changeFlags | ( | ) | const |
Referenced by setTotalChangeFlags().
QPointF QPinchGesture::lastCenterPoint | ( | ) | const |
Referenced by setChangeFlags().
qreal QPinchGesture::lastRotationAngle | ( | ) | const |
Referenced by setScaleFactor().
qreal QPinchGesture::lastScaleFactor | ( | ) | const |
Referenced by setCenterPoint().
qreal QPinchGesture::rotationAngle | ( | ) | const |
Referenced by setScaleFactor().
qreal QPinchGesture::scaleFactor | ( | ) | const |
Referenced by setCenterPoint().
void QPinchGesture::setCenterPoint | ( | const QPointF & | value | ) |
Definition at line 611 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setChangeFlags | ( | ChangeFlags | value | ) |
Definition at line 581 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setLastCenterPoint | ( | const QPointF & | value | ) |
Definition at line 606 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::reset().
void QPinchGesture::setLastRotationAngle | ( | qreal | value | ) |
Definition at line 668 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setLastScaleFactor | ( | qreal | value | ) |
Definition at line 637 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setRotationAngle | ( | qreal | value | ) |
Definition at line 673 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setScaleFactor | ( | qreal | value | ) |
Definition at line 642 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setStartCenterPoint | ( | const QPointF & | value | ) |
Definition at line 601 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setTotalChangeFlags | ( | ChangeFlags | value | ) |
Definition at line 571 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::recognize(), and QMacPinchGestureRecognizer::reset().
void QPinchGesture::setTotalRotationAngle | ( | qreal | value | ) |
Definition at line 663 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::reset().
void QPinchGesture::setTotalScaleFactor | ( | qreal | value | ) |
Definition at line 632 of file qgesture.cpp.
Referenced by QMacPinchGestureRecognizer::reset().
QPointF QPinchGesture::startCenterPoint | ( | ) | const |
Referenced by setChangeFlags().
ChangeFlags QPinchGesture::totalChangeFlags | ( | ) | const |
Referenced by QPinchGesture().
qreal QPinchGesture::totalRotationAngle | ( | ) | const |
Referenced by setScaleFactor().
qreal QPinchGesture::totalScaleFactor | ( | ) | const |
Referenced by setCenterPoint().
|
friend |
Definition at line 195 of file qgesture.h.
QPointF QPinchGesture::centerPoint |
the current center point
The center point is the midpoint between the two input points in the gesture.
Definition at line 163 of file qgesture.h.
QPinchGesture::ChangeFlags QPinchGesture::changeFlags |
the property of the gesture that has changed in the current step
This property indicates which of the other properties has changed since the previous gesture event included information about this gesture. You can use this information to determine which aspect of your user interface needs to be updated.
Definition at line 151 of file qgesture.h.
Referenced by QMacPinchGestureRecognizer::recognize().
QPointF QPinchGesture::lastCenterPoint |
the last position of the center point recorded for this gesture
Definition at line 162 of file qgesture.h.
qreal QPinchGesture::lastRotationAngle |
the last reported angle covered by the gesture motion
The last rotation angle is the angle as reported in the rotationAngle property when a previous gesture event was delivered for this gesture.
Definition at line 158 of file qgesture.h.
qreal QPinchGesture::lastScaleFactor |
the last scale factor recorded for this gesture
The last scale factor contains the scale factor reported in the scaleFactor property when a previous gesture event included information about this gesture.
If no previous event was delivered with information about this gesture (i.e., this gesture object contains information about the first movement in the gesture) then this property contains zero.
Definition at line 154 of file qgesture.h.
qreal QPinchGesture::rotationAngle |
the angle covered by the gesture motion
Definition at line 159 of file qgesture.h.
Referenced by QMacPinchGestureRecognizer::recognize().
qreal QPinchGesture::scaleFactor |
the current scale factor
The scale factor measures the scale factor associated with the distance between two of the user's inputs on a touch device.
Definition at line 155 of file qgesture.h.
Referenced by QMacPinchGestureRecognizer::recognize().
QPointF QPinchGesture::startCenterPoint |
the starting position of the center point
Definition at line 161 of file qgesture.h.
Referenced by QMacPinchGestureRecognizer::recognize().
QPinchGesture::ChangeFlags QPinchGesture::totalChangeFlags |
the property of the gesture that has change
This property indicates which of the other properties has changed since the gesture has started. You can use this information to determine which aspect of your user interface needs to be updated.
Definition at line 150 of file qgesture.h.
Referenced by QMacPinchGestureRecognizer::recognize().
qreal QPinchGesture::totalRotationAngle |
the total angle covered by the gesture
This total angle measures the complete angle covered by the gesture. Usually, this is equal to the value held by the rotationAngle property, except in the case where the user performs multiple rotations by removing and repositioning one of the touch points, as described above. In this case, the total angle will be the sum of the rotation angles for the multiple stages of the gesture.
Definition at line 157 of file qgesture.h.
qreal QPinchGesture::totalScaleFactor |
the total scale factor
The total scale factor measures the total change in scale factor from the original value to the current scale factor.
Definition at line 153 of file qgesture.h.