PointerHandler QML Type (Uncreatable)

Gestionnaire abstrait pour les événements de pointeur. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

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

Propriétés

• active : bool
• cursorShape : Qt::CursorShape
• dragThreshold : int
• enabled : bool
• grabPermissions : flags
• margin : real
• parent : Item
• target : Item

Signaux

• canceled(eventPoint point)
• grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

Description détaillée

PointerHandler est la classe de base des gestionnaires d'entrée (non enregistrée en tant que type QML) pour les événements provenant de tout type de périphérique de pointage (écran tactile, souris ou tablette graphique).

Documentation des propriétés

active : bool [read-only]

Cette propriété prend la valeur « true » dès lors que ce gestionnaire d’entrée a pris la responsabilité exclusive de la gestion d’un ou plusieurs « eventPoints », en ayant réussi à s’approprier de manière exclusive ces points. Cela signifie qu’il maintient ses propriétés à jour en fonction des mouvements de ces « eventPoints » et qu’il manipule activement ses « target » (le cas échéant).

cursorShape : Qt::CursorShape

Cette propriété définit la forme du curseur qui s'affichera dès que la souris survolera l'élément « parent » lorsque « active » est défini sur « true ».

Les formes de curseur disponibles sont les suivantes :

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.CursorTailleVerticale
• Qt.CursorTailleHoriz
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.CurseurVide
• Qt.Cursor-division-vert
• Qt.Cursor à division horizontale
• Qt.CurseurMainPointant
• Qt.CurseurInterdit
• Qt.Cursor« Qu'est-ce que c'est ? »
• Qt.CursorOccupé
• Qt.CursorMainOuverte
• Qt.CurseurMainFermée
• Qt.CurseurGlisserCopier
• Qt.CurseurGlissementDéplacement
• Qt.DragLinkCursor

La valeur par défaut n'est pas définie, ce qui permet l'affichage de l'élémen « cursor » d'parent. Cette propriété peut être réinitialisée à son état initial en lui attribuant la valeur « undefined ».

Voir également Qt::CursorShape, QQuickItem::cursor() et HoverHandler::cursorShape.

dragThreshold : int

Distance en pixels sur laquelle l’utilisateur doit faire glisser un élément « eventPoint » pour que cette action soit considérée comme un geste de glissement.

La valeur par défaut dépend de la plateforme et de la résolution de l'écran. Elle peut être réinitialisée à sa valeur par défaut en la définissant sur « undefined ». Le comportement lors du début d'un geste de glissement varie selon les gestionnaires.

enabled : bool

Si un « PointerHandler » est désactivé, il rejettera tous les événements et aucun signal ne sera émis.

Si la propriété « parent » d'un PointerHandler est définie sur « disabled », le gestionnaire sera également désactivé, même si la propriété « enabled » reste définie sur « true ».

grabPermissions : flags

Cette propriété définit les autorisations lorsque la logique de ce gestionnaire décide de prendre le contrôle exclusif, ou lorsqu'il est invité à approuver la prise de contrôle ou l'annulation de celle-ci par un autre gestionnaire.

La valeur par défaut est « PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything », ce qui autorise la plupart des scénarios de prise de contrôle tout en évitant, par exemple, que deux PinchHandlers ne se disputent les mêmes points de contact.

margin : real

La marge située au-delà des limites de l'élément « parent », à l'intérieur de laquelle un « eventPoint » peut activer ce gestionnaire. Par exemple, sur une page PinchHandler où l'élément « target » est également le « parent », il est utile de définir cette distance à au moins la moitié de la largeur du doigt d'un utilisateur type, afin que, si l'élément « parent » a été réduit à une très petite taille, le geste de pincement reste possible. De même, si un bouton basé sur l'TapHandler est placé près du bord de l'écran, cela permet de respecter la loi de Fitts : réagir aux clics de souris au bord de l'écran même si le bouton est visuellement espacé de quelques pixels par rapport à ce bord.

La valeur par défaut est 0.

parent : Item

L'Item, qui correspond au champ d'application du gestionnaire ; l'élément (Item) dans lequel il a été déclaré. Le gestionnaire traitera les événements pour le compte de cet élément, ce qui signifie qu'un événement de pointeur est pertinent si au moins l'un de ses points d'eventPoints se situe à l'intérieur de l'élément. Au départ, target() est identique, mais il peut être réattribué.

Voir également ` target ` et ` QObject::parent()`.

target : Item

L'élément que ce gestionnaire va manipuler.

Par défaut, il s’agit de l’ parent, c’est-à-dire l’élément dans lequel le gestionnaire est déclaré. Cependant, il peut parfois être utile de définir la cible sur un autre élément, afin de gérer les événements au sein d’un élément mais d’en manipuler un autre ; ou d’ null, pour désactiver le comportement par défaut et effectuer une autre action à la place.

Documentation sur les signaux

canceled(eventPoint point)

Si ce gestionnaire a déjà saisi l'point donné, ce signal est émis lorsqu'un autre gestionnaire de pointeur ou un autre objet lui vole la saisie.

grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

Ce signal est émis lorsque le « grab » a subi une modification pertinente pour ce gestionnaire.

Le verbe « transition » indique ce qui s'est passé. L'objet « point » correspond au point qui a été sélectionné ou désélectionné.

Les valeurs valides pour « transition » sont :