QPinchGesture Class
La clase QPinchGesture describe un gesto de pellizco realizado por el usuario. Más información...
| Encabezado: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan de: | QGesture |
Tipos públicos
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
Propiedades
|
|
Funciones públicas
| 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 |
Descripción detallada
Un gesto de pellizco es una forma de entrada táctil en la que el usuario suele tocar dos puntos del dispositivo de entrada con el pulgar y otro dedo, antes de acercarlos o separarlos para cambiar el factor de escala, el zoom o el nivel de detalle de la interfaz de usuario.
Para obtener una visión general del manejo de gestos en Qt e información sobre el uso de gestos en tus aplicaciones, consulta el documento «Gestos en Qt Widgets y la vista gráfica ».

En lugar de repetir el mismo gesto de pellizco, el usuario puede mantener el dedo en un punto del dispositivo de entrada y tocar un segundo punto para continuar el gesto. Cuando esto ocurre, se seguirán enviando eventos de gesto al objeto de destino, que contendrán una instancia de `QPinchGesture` en el estado « Qt::GestureUpdated ».
Véase también « QPanGesture » y « QSwipeGesture ».
Documentación sobre los tipos de miembros
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
Esta enumeración describe los cambios que pueden producirse en las propiedades del objeto de gesto.
| Constante | Valor | Descripción |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | El factor de escala de « scaleFactor » ha cambiado. |
QPinchGesture::RotationAngleChanged | 0x2 | El ángulo de rotación que contiene « rotationAngle » ha cambiado. |
QPinchGesture::CenterPointChanged | 0x4 | El punto central almacenado por ` centerPoint ` ha cambiado. |
El tipo ChangeFlags es una definición de tipo (typedef) para QFlags<ChangeFlag>. Almacena una combinación OR de valores de ChangeFlag.
Véase también changeFlags y totalChangeFlags.
Documentación de la propiedad
centerPoint : QPointF
Esta propiedad contiene el punto central actual
El punto central es el punto medio entre los dos puntos de entrada del gesto.
Funciones de acceso:
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
Véase también startCenterPoint y lastCenterPoint.
changeFlags : ChangeFlags
Esta propiedad contiene la propiedad del gesto que ha cambiado en el paso actual
Esta propiedad indica cuál de las demás propiedades ha cambiado desde que el evento de gesto anterior incluyó información sobre este gesto. Puede utilizar esta información para determinar qué aspecto de su interfaz de usuario debe actualizarse.
Funciones de acceso:
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
Véase también totalChangeFlags, scaleFactor, rotationAngle y centerPoint.
lastCenterPoint : QPointF
Esta propiedad contiene la última posición del punto central registrada para este gesto
Funciones de acceso:
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
Véase también centerPoint y startCenterPoint.
lastRotationAngle : qreal
Esta propiedad contiene el último ángulo registrado por el movimiento del gesto
El último ángulo de rotación es el ángulo indicado en la propiedad « rotationAngle » cuando se envió un evento de gesto anterior para este gesto.
Funciones de acceso:
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
Véase también « rotationAngle » y « totalRotationAngle ».
lastScaleFactor : qreal
Esta propiedad contiene el último factor de escala registrado para este gesto
El último factor de escala contiene el factor de escala indicado en la propiedad « scaleFactor » cuando un evento de gesto anterior incluía información sobre este gesto.
Si no se ha enviado ningún evento anterior con información sobre este gesto (es decir, este objeto de gesto contiene información sobre el primer movimiento del gesto), esta propiedad contiene el valor cero.
Funciones de acceso:
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
Véase también « scaleFactor » y « totalScaleFactor ».
rotationAngle : qreal
Esta propiedad contiene el ángulo que abarca el movimiento del gesto
Funciones de acceso:
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
Véase también totalRotationAngle y lastRotationAngle.
scaleFactor : qreal
Esta propiedad contiene el factor de escala actual
El factor de escala mide la relación de escala asociada a la distancia entre dos de las entradas del usuario en un dispositivo táctil.
Funciones de acceso:
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
Véase también totalScaleFactor y lastScaleFactor.
startCenterPoint : QPointF
Esta propiedad contiene la posición inicial del punto central
Funciones de acceso:
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
Véase también centerPoint y lastCenterPoint.
totalChangeFlags : ChangeFlags
Esta propiedad contiene la propiedad del gesto que ha cambiado
Esta propiedad indica cuál de las demás propiedades ha cambiado desde que se inició el gesto. Puedes utilizar esta información para determinar qué aspecto de tu interfaz de usuario debe actualizarse.
Funciones de acceso:
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
Véase también changeFlags, scaleFactor, rotationAngle y centerPoint.
totalRotationAngle : qreal
Esta propiedad contiene el ángulo total que abarca el gesto
Este ángulo total mide el ángulo completo que abarca el gesto. Por lo general, es igual al valor que contiene la propiedad « rotationAngle », salvo en el caso de que el usuario realice varias rotaciones retirando y recolocando uno de los puntos táctiles, tal y como se ha descrito anteriormente. En este caso, el ángulo total será la suma de los ángulos de rotación de las distintas fases del gesto.
Funciones de acceso:
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
Véase también « rotationAngle » y « lastRotationAngle ».
totalScaleFactor : qreal
Esta propiedad recoge el factor de escala total
El factor de escala total mide la variación total del factor de escala desde el valor original hasta el factor de escala actual.
Funciones de acceso:
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
Véase también scaleFactor y 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.