QPinchGesture Class
La classe QPinchGesture décrit un geste de pincement effectué par l'utilisateur. Plus d'informations...
| En-tête : | #include <QPinchGesture> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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 utilisateur tactile dans laquelle l'utilisateur touche généralement deux points sur le périphérique d'entrée avec le pouce et le 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 vue d'ensemble de la gestion des gestes dans Qt Widgets et des informations sur l'utilisation des gestes dans vos applications, consultez le document Gestes dans les widgets et la vue graphique.
Au lieu de répéter le même geste de pincement, l'utilisateur peut continuer à toucher le périphérique d'entrée à un endroit, et appliquer un second toucher à un nouveau point, poursuivant ainsi le geste. Dans ce cas, les événements de geste continueront d'être transmis à l'objet cible, qui contient une instance de QPinchGesture dans 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 qui peuvent être apportées aux propriétés de l'objet gestuel.
| Constante | Valeur | Description |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | Le facteur d'échelle détenu par scaleFactor a changé. |
QPinchGesture::RotationAngleChanged | 0x2 | L'angle de rotation défini par rotationAngle a changé. |
QPinchGesture::CenterPointChanged | 0x4 | Le point central défini par centerPoint a changé. |
Le type ChangeFlags est un typedef pour QFlags<ChangeFlag>. Il stocke une combinaison OU 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 est le point médian 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é dans l'étape en cours
Cette propriété indique laquelle des autres propriétés a changé depuis que l'événement de geste précédent a inclus 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 aussi totalChangeFlags, scaleFactor, rotationAngle, et centerPoint.
lastCenterPoint : QPointF
Cette propriété contient la dernière position du point central enregistré pour ce geste
Fonctions d'accès :
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
Voir aussi centerPoint et startCenterPoint.
lastRotationAngle : qreal
Cette propriété contient le dernier angle signalé couvert par le mouvement du geste
Le dernier angle de rotation est l'angle indiqué dans la propriété rotationAngle lorsqu'un événement de geste précédent a été délivré 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 contient le 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 antérieur n'a été fourni avec des informations sur ce geste (c'est-à-dire que cet objet gestuel contient des informations sur le premier mouvement du geste), cette propriété contient 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 aussi totalRotationAngle et lastRotationAngle.
scaleFactor : qreal
Cette propriété contient le facteur d'échelle actuel
Le facteur d'échelle mesure le facteur d'échelle associé à la distance entre deux entrées de l'utilisateur sur un dispositif tactile.
Fonctions d'accès :
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
Voir aussi totalScaleFactor et lastScaleFactor.
startCenterPoint : QPointF
Cette propriété contient la position de départ du point central
Fonctions d'accès :
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
Voir aussi centerPoint et lastCenterPoint.
totalChangeFlags : ChangeFlags
Cette propriété contient la propriété du geste qui a changé
Cette propriété indique laquelle des autres propriétés a changé depuis le début du geste. Vous pouvez utiliser cette information 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 aussi 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 des rotations multiples en retirant et en repositionnant l'un des points de contact, comme décrit ci-dessus. Dans ce cas, l'angle total sera la somme des angles de rotation pour les 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.
