QPinchGesture Class
La classe QPinchGesture décrit un geste de pincement effectué par l'utilisateur. En savoir plus...
| En-tête : | #include <QPinchGesture> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QGesture |
Types publics
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
Propriétés
|
|
Fonctions publiques
| virtual | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::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(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
Description détaillée
Un geste de pincement est une forme d'entrée tactile dans laquelle l'utilisateur touche généralement deux points sur le périphérique d'entrée avec un pouce et un doigt, avant de les rapprocher ou de les éloigner pour modifier le facteur d'échelle, le zoom ou le niveau de détail de l'interface utilisateur.
Pour une présentation générale de la gestion des gestes dans Qt et des informations sur leur utilisation dans vos applications, consultez le document « Gestes dans les widgets et la vue graphique ».
Au lieu d’appliquer de manière répétée le même geste de pincement, l’utilisateur peut continuer à toucher le périphérique d’entrée au même endroit, puis effectuer un deuxième contact sur un nouveau point pour poursuivre le geste. Dans ce cas, des événements de geste continueront d’être transmis à l’objet cible, contenant une instance de QPinchGesture à l’état « Qt::GestureUpdated ».
Voir également « QPanGesture » et « QSwipeGesture ».
Documentation sur les types de membres
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
Cette énumération décrit les modifications pouvant intervenir au niveau des propriétés de l'objet « geste ».
| Constante | Valeur | Description |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | Le facteur d'échelle de l'scaleFactor a changé. |
QPinchGesture::RotationAngleChanged | 0x2 | L'angle de rotation de l'rotationAngle a changé. |
QPinchGesture::CenterPointChanged | 0x4 | Le point central de l'centerPoint a changé. |
Le type ChangeFlags est un typedef pour QFlags<ChangeFlag>. Il stocke une combinaison OR de valeurs ChangeFlag.
Voir également changeFlags et totalChangeFlags.
Documentation sur les propriétés
centerPoint : QPointF
Cette propriété contient le point central actuel
Le point central correspond au milieu entre les deux points d'entrée du geste.
Fonctions d'accès :
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
Voir également startCenterPoint et lastCenterPoint.
changeFlags : ChangeFlags
Cette propriété contient la propriété du geste qui a changé au cours de l'étape actuelle
Cette propriété indique laquelle des autres propriétés a changé depuis que l’événement de geste précédent contenait des informations sur ce geste. Vous pouvez utiliser ces informations pour déterminer quel aspect de votre interface utilisateur doit être mis à jour.
Fonctions d'accès :
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
Voir également totalChangeFlags, scaleFactor, rotationAngle et centerPoint.
lastCenterPoint : QPointF
Cette propriété contient la dernière position du point central enregistrée pour ce geste
Fonctions d'accès :
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
Voir également centerPoint et startCenterPoint.
lastRotationAngle : qreal
Cette propriété contient le dernier angle enregistré correspondant au mouvement du geste
Le dernier angle de rotation correspond à l’angle indiqué dans la propriété « rotationAngle » lors de la transmission d’un événement de geste précédent pour ce geste.
Fonctions d'accès :
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
Voir également rotationAngle et totalRotationAngle.
lastScaleFactor : qreal
Cette propriété contient le dernier facteur d'échelle enregistré pour ce geste
Le dernier facteur d'échelle correspond au facteur d'échelle indiqué dans la propriété « scaleFactor » lorsqu'un événement de geste précédent comprenait des informations sur ce geste.
Si aucun événement précédent n’a été transmis avec des informations concernant ce geste (c’est-à-dire que cet objet de geste contient des informations sur le premier mouvement du geste), cette propriété contient alors zéro.
Fonctions d'accès :
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
Voir également scaleFactor et totalScaleFactor.
rotationAngle : qreal
Cette propriété contient l'angle couvert par le mouvement du geste
Fonctions d'accès :
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
Voir également totalRotationAngle et lastRotationAngle.
scaleFactor : qreal
Cette propriété contient le facteur d'échelle actuel
Le facteur d'échelle mesure le rapport entre la distance entre deux saisies de l'utilisateur sur un appareil tactile.
Fonctions d'accès :
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
Voir également totalScaleFactor et lastScaleFactor.
startCenterPoint : QPointF
Cette propriété contient la position initiale du point central
Fonctions d'accès :
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
Voir également centerPoint et lastCenterPoint.
totalChangeFlags : ChangeFlags
Cette propriété contient la propriété du geste qui a été modifiée
Cette propriété indique laquelle des autres propriétés a changé depuis le début du geste. Vous pouvez utiliser ces informations pour déterminer quel aspect de votre interface utilisateur doit être mis à jour.
Fonctions d'accès :
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
Voir également changeFlags, scaleFactor, rotationAngle et centerPoint.
totalRotationAngle : qreal
Cette propriété contient l'angle total couvert par le geste
Cet angle total mesure l'angle complet couvert par le geste. En général, il est égal à la valeur de la propriété « rotationAngle », sauf dans le cas où l'utilisateur effectue plusieurs rotations en retirant puis en repositionnant l'un des points de contact, comme décrit ci-dessus. Dans ce cas, l'angle total correspondra à la somme des angles de rotation des différentes étapes du geste.
Fonctions d'accès :
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
Voir également « rotationAngle » et « lastRotationAngle ».
totalScaleFactor : qreal
Cette propriété contient le facteur d'échelle total
Le facteur d'échelle total mesure la variation totale du facteur d'échelle entre la valeur d'origine et le facteur d'échelle actuel.
Fonctions d'accès :
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
Voir également scaleFactor et lastScaleFactor.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
