PinchArea QML Type

Permet de gérer simplement les gestes de pincement. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Signaux

• pinchFinished(PinchEvent pinch)
• pinchStarted(PinchEvent pinch)
• pinchUpdated(PinchEvent pinch)
• smartZoom(PinchEvent pinch)

Description détaillée

Une PinchArea est un élément invisible qui est généralement utilisé en conjonction avec un élément visible afin de gérer les gestes de pincement pour cet élément.

La propriété enabled permet d'activer et de désactiver la gestion du pincement pour l'élément mandataire. Lorsqu'elle est désactivée, la zone de pincement devient transparente aux événements souris/touche.

PinchArea peut être utilisé de deux manières :

• en définissant une adresse pinch.target pour permettre une interaction automatique avec un élément
• en utilisant les gestionnaires onPinchStarted, onPinchUpdated et onPinchFinished.

Depuis Qt 5.5, PinchArea peut réagir aux événements natifs de geste de pincement du système d'exploitation s'ils sont disponibles ; sinon, il ne réagit qu'aux événements tactiles.

Voir également PinchEvent, QNativeGestureEvent, et QTouchEvent.

Documentation sur les propriétés

enabled : bool

Cette propriété indique si l'élément accepte les gestes de pincement.

La valeur par défaut de cette propriété est true.

pinch group

pinch fournit un moyen pratique de faire réagir un élément aux gestes de pincement.

• pinch.target spécifie l'identifiant de l'élément à faire glisser.
• pinch.active spécifie si l'élément cible est en train d'être déplacé.
• pinch.minimumScale et pinch.maximumScale limitent la portée de la propriété Item.scale, mais pas la propriété PinchEvent scale .
• pinch.minimumRotation et pinch.maximumRotation limitent la portée de la propriété Item.rotation, mais pas la propriété PinchEvent rotation .
• pinch.dragAxis spécifie si le glissement n'est pas autorisé (Pinch.NoDrag), s'il peut être effectué horizontalement (Pinch.XAxis), verticalement (Pinch.YAxis), ou les deux (Pinch.XAndYAxis).
• pinch.minimum et pinch.maximum limitent la distance à laquelle la cible peut être déplacée le long des axes correspondants.

Documentation sur le signal

pinchFinished(PinchEvent pinch)

Ce signal est émis lorsque la zone de pincement détecte qu'un geste de pincement est terminé.

Le paramètre pinch (différent de la propriété pinch ) fournit des informations sur le geste de pincement, notamment l'échelle, le centre et l'angle du pincement.

pinchStarted(PinchEvent pinch)

Ce signal est émis lorsque la zone de pincement détecte qu'un geste de pincement a commencé : deux points de contact (doigts) ont été détectés et se sont déplacés au-delà du seuil startDragDistance pour que le geste commence.

Le paramètre pinch (différent de la propriété pinch ) fournit des informations sur le geste de pincement, notamment l'échelle, le centre et l'angle du pincement. Au moment du signal pinchStarted, ces valeurs sont réinitialisées aux valeurs par défaut, quels que soient les résultats des gestes précédents : pinch.scale sera 1.0 et pinch.rotation sera 0.0. Au fur et à mesure de la progression du geste, pinchUpdated signalera l'écart par rapport à ces valeurs par défaut.

Pour ignorer ce geste, réglez la propriété pinch.accepted sur false. Le geste sera annulé et aucun autre événement ne sera envoyé.

pinchUpdated(PinchEvent pinch)

Ce signal est émis lorsque la zone de pincement détecte qu'un geste de pincement a changé.

Le paramètre pinch fournit des informations sur le geste de pincement, notamment l'échelle, le centre et l'angle du pincement. Ces valeurs ne reflètent que les changements intervenus depuis le début du geste en cours et ne sont donc pas limitées par les limites minimales et maximales de la propriété pinch.

smartZoom(PinchEvent pinch)

Ce signal est émis lorsque la zone de pincement détecte un geste de zoom intelligent. Ce geste ne se produit que sur certains systèmes d'exploitation tels que macOS.

Le paramètre pinch fournit des informations sur le geste de pincement, y compris l'endroit où le geste s'est produit. pinch.scale sera supérieur à zéro lorsque le geste indique que l'utilisateur souhaite entrer dans le zoom intelligent, et zéro lorsqu'il en sort (même si le même geste est généralement utilisé pour passer d'un état à l'autre).