PinchArea QML Type

Habilita el manejo simple de gestos de pellizco. Más...

• Lista de todos los miembros, incluidos los heredados

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 se utiliza normalmente en conjunción con un elemento visible con el fin de proporcionar el manejo de gestos de pellizco para ese elemento.

La propiedad enabled se utiliza para habilitar y deshabilitar el manejo de pellizcos para el elemento proxy. Cuando está deshabilitada, el área de pellizco se vuelve transparente a los eventos de ratón/toque.

PinchArea puede utilizarse de dos formas:

• estableciendo un pinch.target para proporcionar interacción automática con un elemento
• usando los manejadores onPinchStarted, onPinchUpdated y onPinchFinished

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

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

Documentación de propiedades

enabled : bool

Esta propiedad indica si el elemento acepta gestos de pellizco.

El valor predeterminado de esta propiedad es true.

pinch group

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

• pinch.target especifica el id del elemento a arrastrar.
• pinch.active especifica si el ítem objetivo está siendo arrastrado.
• pinch.minimumScale y pinch.maximumScale limitan el rango de la propiedad Item.scale, pero no la propiedad PinchEvent scale .
• pinch.minimumRotation y pinch.maximumRotation limitan el rango de la propiedad Item.rotation, pero no la propiedad PinchEvent rotation .
• pinch.dragAxis especifica si el arrastre no está permitido (Pinch.NoDrag), puede hacerse horizontalmente (Pinch.XAxis), verticalmente (Pinch.YAxis), o ambos (Pinch.XAndYAxis)
• pinch.minimum y pinch.maximum limitan la distancia a la que se puede arrastrar el objetivo a lo largo de los ejes correspondientes.

Documentación de señales

pinchFinished(PinchEvent pinch)

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

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

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 se han desplazado más allá del umbral startDragDistance para que comience el gesto.

El parámetro pinch (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 pellizco. En el momento de la señal pinchStarted, estos valores se restablecen a los valores por defecto, independientemente de los resultados de gestos anteriores: pellizco.escala será 1.0 y pellizco.rotación será 0.0. A medida que avance el gesto, pinchUpdated informará de la desviación respecto a esos valores por defecto.

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

pinchUpdated(PinchEvent pinch)

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

El parámetro pinch proporciona información sobre el gesto de pellizco, incluyendo la escala, el centro y el ángulo del pellizco. Estos valores reflejan cambios sólo desde el comienzo del gesto actual, y por lo tanto no están limitados por los límites mínimo y máximo de la propiedad pinch.

smartZoom(PinchEvent pinch)

Esta señal se emite cuando el área de pellizco detecta un gesto de zoom inteligente. Este gesto sólo 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 produjo el gesto. pinch.scale será mayor que cero cuando el gesto indique que el usuario desea entrar en zoom inteligente, y cero al salir (aunque normalmente se utiliza el mismo gesto para alternar entre los dos estados).