QPinchGesture Class
La clase QPinchGesture describe un gesto de pellizco realizado por el usuario. Más...
| Cabecera: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 de usuario táctil en la que el usuario suele tocar dos puntos del dispositivo de entrada con el pulgar y el dedo, antes de acercarlos o alejarlos para cambiar el factor de escala, el zoom o el nivel de detalle de la interfaz de usuario.
Para una visión general del manejo de gestos en Qt e información sobre cómo utilizar gestos en tus aplicaciones, consulta el documento Gestos en Widgets y Vista Gráfica.
En lugar de aplicar repetidamente el mismo gesto de pellizcar, el usuario puede continuar tocando el dispositivo de entrada en un lugar, y aplicar un segundo toque en un nuevo punto, continuando el gesto. Cuando esto ocurre, los eventos del gesto continuarán siendo enviados al objeto de destino, que contiene una instancia de QPinchGesture en el estado Qt::GestureUpdated.
Véase también QPanGesture y QSwipeGesture.
Documentación de tipos de miembros
enum QPinchGesture::ChangeFlag
flags QPinchGesture::ChangeFlags
Este enum describe los cambios que pueden producirse en las propiedades del objeto gesture.
| Constante | Valor | Descripción |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | El factor de escala mantenido por scaleFactor ha cambiado. |
QPinchGesture::RotationAngleChanged | 0x2 | El ángulo de rotación mantenido por rotationAngle ha cambiado. |
QPinchGesture::CenterPointChanged | 0x4 | El punto central mantenido por centerPoint ha cambiado. |
El tipo ChangeFlags es un typedef para QFlags<ChangeFlag>. Almacena una combinación OR de valores ChangeFlag.
Ver también changeFlags y totalChangeFlags.
Documentación de Propiedades
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 otras 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 registrado 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 informado cubierto por el movimiento gestual.
El último ángulo de rotación es el ángulo reportado en la propiedad rotationAngle cuando un evento de gesto previo fue entregado 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 reportado en la propiedad scaleFactor cuando un evento de gesto previo incluyó información sobre este gesto.
Si no se entregó ningún evento previo con información sobre este gesto (es decir, este objeto de gesto contiene información sobre el primer movimiento del gesto) entonces esta propiedad contiene 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 cubierto por el movimiento gestual
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 el factor de escala asociado a la distancia entre dos 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 otras propiedades ha cambiado desde que se inició el gesto. Puede utilizar esta información para determinar qué aspecto de su 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 cubierto por el gesto
Este ángulo total mide el ángulo completo cubierto por el gesto. Normalmente, es igual al valor de la propiedad rotationAngle, excepto en el caso de que el usuario realice múltiples rotaciones quitando y recolocando uno de los puntos táctiles, como se ha descrito anteriormente. En este caso, el ángulo total será la suma de los ángulos de rotación de las múltiples etapas del gesto.
Funciones de acceso:
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
Véase también rotationAngle y lastRotationAngle.
totalScaleFactor : qreal
Esta propiedad contiene el factor de escala total
El factor de escala total mide el cambio total en el 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.
