PinchArea QML Type
Permite gestionar fácilmente el gesto de pellizcar. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
- enabled : bool
- pinch
- pinch.active : bool
- 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
Señales
- pinchFinished(PinchEvent pinch)
- pinchStarted(PinchEvent pinch)
- pinchUpdated(PinchEvent pinch)
- smartZoom(PinchEvent pinch)
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.targetespecifica el identificador del elemento que se va a arrastrar.pinch.activeEspecifica si el elemento de destino se está arrastrando en ese momento.pinch.minimumScaleypinch.maximumScalelimitan el rango de la propiedad Item.scale, pero no el de la propiedadPinchEventscale .pinch.minimumRotationypinch.maximumRotationlimitan el rango de la propiedad Item.rotation, pero no el dePinchEventrotation .pinch.dragAxisEspecifica 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.minimumypinch.maximumlimitan 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.