En esta página

PinchArea QML Type

Permite gestionar fácilmente el gesto de pellizcar. Más...

Import Statement: import QtQuick
Inherits:

Item

Propiedades

Señales

Descripción detallada

Un PinchArea es un elemento invisible que suele utilizarse junto con un elemento visible para permitir el manejo de gestos de pellizco en dicho elemento.

La propiedad « enabled » se utiliza para activar y desactivar el manejo del gesto de pellizco para el elemento al que hace referencia. Cuando está desactivada, el área de pellizco se vuelve transparente a los eventos de ratón o táctiles.

PinchArea se puede utilizar de dos formas:

  • estableciendo un valor de « pinch.target » para proporcionar interacción automática con un elemento
  • utilizando los controladores onPinchStarted, onPinchUpdated y onPinchFinished

Desde Qt 5.5, PinchArea puede reaccionar a eventos de gestos de pellizco nativos del sistema operativo, si están disponibles; de lo contrario, solo reacciona a eventos táctiles.

Véase también PinchEvent, QNativeGestureEvent y QTouchEvent.

Documentación de propiedades

enabled : bool

Esta propiedad indica si el elemento admite gestos de pellizco.

El valor predeterminado de esta propiedad es «true».

pinch group

pinch.active : bool [read-only]

pinch.dragAxis : enumeration

pinch.maximumRotation : real

pinch.maximumScale : real

pinch.maximumX : real

pinch.maximumY : real

pinch.minimumRotation : real

pinch.minimumScale : real

pinch.minimumX : real

pinch.minimumY : real

pinch.target : Item

pinch ofrece una forma práctica de hacer que un elemento reaccione a los gestos de pellizco.

  • pinch.target especifica el identificador del elemento que se va a arrastrar.
  • pinch.active Especifica si el elemento de destino se está arrastrando en ese momento.
  • pinch.minimumScale y pinch.maximumScale limitan el rango de la propiedad Item.scale, pero no el de la propiedad PinchEvent scale .
  • pinch.minimumRotation y pinch.maximumRotation limitan el rango de la propiedad Item.rotation, pero no el de PinchEvent rotation .
  • pinch.dragAxis Especifica si no se permite arrastrar (Pinch.NoDrag), si se puede hacer en horizontal (Pinch.XAxis), en vertical (Pinch.YAxis) o en ambos sentidos (Pinch.XAndYAxis)
  • pinch.minimum y pinch.maximum limitan la distancia a la que se puede arrastrar el elemento de destino a lo largo de los ejes correspondientes.

Documentación de Signal

pinchFinished(PinchEvent pinch)

Esta señal se emite cuando el área de pellizco detecta que ha finalizado un gesto de pellizco.

El parámetro « pinch » (que no es lo mismo que la propiedad « pinch ») proporciona información sobre el gesto de pellizco, incluyendo la escala, el centro y el ángulo del mismo.

Nota: El controlador correspondiente es onPinchFinished.

pinchStarted(PinchEvent pinch)

Esta señal se emite cuando el área de pellizco detecta que se ha iniciado un gesto de pellizco: se han detectado dos puntos de contacto (dedos) y estos se han desplazado más allá del umbral de « startDragDistance » para que comience el gesto.

El parámetro pinch (que no es lo mismo que la propiedad pinch ) proporciona información sobre el gesto de pellizco, incluyendo la escala, el centro y el ángulo del mismo. En el momento en que se emite la señal « pinchStarted », estos valores se restablecen a sus valores predeterminados, independientemente de los resultados de los gestos anteriores: «pinch.scale» será 1.0 y «pinch.rotation» será 0.0. A medida que avanza el gesto, « pinchUpdated » informará de la desviación respecto a esos valores predeterminados.

Para ignorar este gesto, establece la propiedad pinch.accepted en false. El gesto se cancelará y no se enviarán más eventos.

Nota: El controlador correspondiente es onPinchStarted.

pinchUpdated(PinchEvent pinch)

Esta señal se emite cuando el área de pellizco detecta que se ha producido un cambio en el gesto de pellizco.

El parámetro ` pinch ` proporciona información sobre el gesto de pellizco, incluyendo la escala, el centro y el ángulo del mismo. Estos valores reflejan únicamente los cambios producidos desde el inicio del gesto actual y, por lo tanto, no están sujetos a los límites mínimo y máximo de la propiedad ` pinch `.

Nota: El controlador correspondiente es onPinchUpdated.

smartZoom(PinchEvent pinch)

Esta señal se emite cuando el área de pellizco detecta un gesto de zoom inteligente. Este gesto solo se produce en determinados sistemas operativos, como macOS.

El parámetro ` pinch ` proporciona información sobre el gesto de pellizcar, incluida la ubicación en la que se ha producido el gesto. ` pinch.scale ` será mayor que cero cuando el gesto indique que el usuario desea activar el zoom inteligente, y será cero al salir de él (aunque normalmente se utilice el mismo gesto para alternar entre ambos estados).

Nota: El controlador correspondiente es onSmartZoom.

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