En esta página

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 ».

Demostración del gesto de pellizco con dos dedos

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.

ConstanteValorDescripción
QPinchGesture::ScaleFactorChanged0x1El factor de escala de « scaleFactor » ha cambiado.
QPinchGesture::RotationAngleChanged0x2El ángulo de rotación que contiene « rotationAngle » ha cambiado.
QPinchGesture::CenterPointChanged0x4El 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.

Documentación de funciones de miembro

[virtual noexcept] QPinchGesture::~QPinchGesture()

Destructor.

© 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.