QEventPoint Class
La classe `QEventPoint` fournit des informations sur un point situé dans une ` QPointerEvent`. En savoir plus...
| En-tête : | #include <QEventPoint> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Depuis : | Qt 6.0 |
Types publics
Propriétés
|
|
Fonctions publiques
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(QEventPoint &&other) | |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| QEventPoint & | operator=(QEventPoint &&other) |
| QEventPoint & | operator=(const QEventPoint &other) |
| bool | operator==(const QEventPoint &other) const |
Documentation sur les types de membres
enum QEventPoint::State
flags QEventPoint::States
Indique l'état de ce point d'événement.
| Constante | Valeur | Description |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | État inconnu. |
QEventPoint::Stationary | Qt::TouchPointStationary | Le point d'événement n'a pas bougé. |
QEventPoint::Pressed | Qt::TouchPointPressed | Le point de contact ou le bouton a été enfoncé. |
QEventPoint::Updated | Qt::TouchPointMoved | Le point d'événement a été mis à jour. |
QEventPoint::Released | Qt::TouchPointReleased | Le point de contact ou le bouton a été relâché. |
Le type « States » est une définition de type pour QFlags<State>. Il stocke une combinaison OU de valeurs d’état.
Documentation des propriétés
accepted : bool
Cette propriété contient l'état « accepté » du point d'événement.
Dans les applications basées sur des widgets, cette propriété n'est pas utilisée, car un widget n'a de sens que s'il accepte ou rejette un QInputEvent complet.
Dans Qt Quick cependant, il est courant qu’un élément (Item) ou un gestionnaire d’événement (Event Handler) n’accepte que les points individuels d’un ensemble de points ( QTouchEvent ) qui participent effectivement à un geste, tandis que les autres points peuvent être transmis à d’autres éléments ou gestionnaires. Par souci de cohérence, cela s’applique à tout ensemble de points ( QPointerEvent) ; et la transmission n’a lieu que lorsque tous les points d’un ensemble de points ( QPointerEvent ) ont été acceptés.
Fonctions d’accès :
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
Voir également QEvent::accepted.
[read-only] device : const QPointingDevice*
Cette propriété contient le périphérique de pointage à l'origine de cet événement.
Fonctions d'accès :
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Cette propriété contient la largeur et la hauteur de l'ellipse englobante du point de contact.
La valeur renvoyée est exprimée en pixels logiques. La plupart des écrans tactiles ne détectent pas la forme du point de contact, et aucune souris ni tablette ne peut la détecter ; la valeur la plus courante est donc une taille nulle. Sur certains écrans tactiles, les diamètres peuvent être différents de zéro et toujours égaux (l'ellipse est alors approximée par un cercle).
Fonctions d'accès :
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
Cette propriété contient la position globale à laquelle ce point a été sélectionné.
La position globale est relative à l'écran ou au bureau virtuel.
Fonctions d'accès :
| QPointF | globalGrabPosition() const |
Voir également globalPosition, grabPosition et sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Cette propriété contient la position globale de ce point lors de l'événement de pression ou de déplacement précédent.
La position globale est relative à l'écran ou au bureau virtuel.
Fonctions d'accès :
| QPointF | globalLastPosition() const |
Voir également globalPosition, lastPosition et sceneLastPosition.
[read-only] globalPosition : const QPointF
Cette propriété contient la position globale de ce point.
La position globale est relative à l'écran ou au bureau virtuel.
Fonctions d'accès :
| QPointF | globalPosition() const |
Voir également globalPressPosition, position et scenePosition.
[read-only] globalPressPosition : const QPointF
Cette propriété contient la position globale à laquelle ce point a été cliqué.
La position globale est relative à l'écran ou au bureau virtuel.
Fonctions d'accès :
| QPointF | globalPressPosition() const |
Voir également globalPosition, pressPosition et scenePressPosition.
[read-only] grabPosition : const QPointF
Cette propriété contient la position à laquelle ce point a été sélectionné.
La position est relative au widget ou à l'élément qui a reçu l'événement.
Fonctions d'accès :
| QPointF | grabPosition() const |
Voir également position.
[read-only] id : const int
Cette propriété contient le numéro d'identification de ce point d'événement.
Remarque : ne partez pas du principe que les numéros d'identification commencent à zéro ou qu'ils sont consécutifs. Une telle hypothèse est souvent erronée en raison du fonctionnement des pilotes sous-jacents.
Fonctions d'accès :
| int | id() const |
[read-only] lastPosition : const QPointF
Cette propriété contient la position de ce point lors de l'événement de pression ou de déplacement précédent.
La position est relative au widget ou à l'élément qui a reçu l'événement.
Fonctions d'accès :
| QPointF | lastPosition() const |
Voir également position et pressPosition.
[read-only] lastTimestamp : const ulong
Cette propriété contient l'heure de l'QPointerEvent ion précédente qui contenait ce point.
Fonctions d'accès :
| ulong | lastTimestamp() const |
Voir également « globalLastPosition ».
[read-only] position : const QPointF
Cette propriété contient la position de ce point.
La position est relative au widget ou à l'élément qui a reçu l'événement.
Fonctions d'accès :
| QPointF | position() const |
[read-only] pressPosition : const QPointF
Cette propriété contient la position à laquelle ce point a été sélectionné.
La position est relative au widget ou à l'élément qui a reçu l'événement.
Fonctions d'accès :
| QPointF | pressPosition() const |
Voir également position.
[read-only] pressTimestamp : const ulong
Cette propriété contient l'heure la plus récente à laquelle ce bouton a été enfoncé.
Fonctions d'accès :
| ulong | pressTimestamp() const |
Voir également timestamp.
[read-only] pressure : const qreal
Cette propriété contient la pression en ce point.
La valeur renvoyée est comprise entre 0.0 et 1.0.
Fonctions d'accès :
| qreal | pressure() const |
[read-only] rotation : const qreal
Cette propriété contient l'orientation angulaire de ce point.
La valeur renvoyée est exprimée en degrés : zéro (valeur par défaut) indique que le doigt, le jeton ou le stylet est orienté vers le haut ; un angle négatif signifie qu’il est tourné vers la gauche, et un angle positif qu’il est tourné vers la droite. La plupart des écrans tactiles ne détectent pas la rotation ; zéro est donc la valeur la plus courante.
Fonctions d'accès :
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Cette propriété contient la position dans la scène à laquelle ce point a été capturé.
La position dans la scène correspond à la position relative à QQuickWindow si elle est gérée par la méthode QQuickItem::event(), aux coordonnées QGraphicsScene si elle est gérée par une redéfinition de la méthode QGraphicsItem::touchEvent(), ou à la position dans la fenêtre dans le cas des applications utilisant des widgets.
Fonctions d'accès :
| QPointF | sceneGrabPosition() const |
Voir également scenePosition, grabPosition et globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Cette propriété contient la position de ce point dans la scène lors de l'événement « press » ou « move » précédent.
La position dans la scène correspond à la position relative à QQuickWindow si l'événement est géré dans QQuickItem::event(), aux coordonnées QGraphicsScene si l'événement est géré par une redéfinition de QGraphicsItem::touchEvent(), ou à la position dans la fenêtre dans les applications de type widget.
Fonctions d'accès :
| QPointF | sceneLastPosition() const |
Voir également scenePosition et scenePressPosition.
[read-only] scenePosition : const QPointF
Cette propriété contient la position de ce point dans la scène.
La position dans la scène correspond à la position relative à QQuickWindow si elle est gérée par la méthode QQuickItem::event(), aux coordonnées de QGraphicsScene si elle est gérée par une redéfinition de la méthode QGraphicsItem::touchEvent(), ou à la position dans la fenêtre dans le cas des applications utilisant des widgets.
Fonctions d'accès :
| QPointF | scenePosition() const |
Voir également scenePressPosition, position et globalPosition.
[read-only] scenePressPosition : const QPointF
Cette propriété contient la position dans la scène à laquelle ce point a été cliqué.
La position dans la scène correspond à la position relative à QQuickWindow si l'événement est géré dans QQuickItem::event(), aux coordonnées QGraphicsScene si l'événement est géré par une redéfinition de QGraphicsItem::touchEvent(), ou à la position dans la fenêtre dans le cas d'applications utilisant des widgets.
Fonctions d'accès :
| QPointF | scenePressPosition() const |
Voir également scenePosition, pressPosition et globalPressPosition.
[read-only] state : const State
Cette propriété contient l'état actuel du point d'événement.
Fonctions d'accès :
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
Cette propriété contient la durée, en secondes, écoulée depuis que ce bouton a été enfoncé sans avoir été relâché.
Fonctions d'accès :
| qreal | timeHeld() const |
Voir également pressTimestamp et timestamp.
[read-only] timestamp : const ulong
Cette propriété contient l'heure la plus récente à laquelle ce point a été inclus dans une « QPointerEvent ».
Fonctions d'accès :
| ulong | timestamp() const |
Voir aussi QPointerEvent::timestamp().
[read-only] uniqueId : const QPointingDeviceUniqueId
Cette propriété contient l'identifiant unique de ce point ou de ce jeton, le cas échéant.
Elle est souvent invalide (voir isValid()), car les écrans tactiles ne peuvent pas identifier de manière unique les doigts.
Lorsqu’elle provient d’un appel à QTabletEvent, elle identifie le numéro de série du stylet utilisé.
Elle peut identifier un jeton spécifique (objet de référence) lorsque le pilote TUIO est utilisé avec un écran tactile qui les prend en charge.
Fonctions d’accès :
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
Cette propriété contient un vecteur de vitesse, exprimé en pixels par seconde, dans le système de coordonnées de l'écran ou du bureau.
Remarque : si les capacités de l'appareil incluent « QInputDevice::Velocity », cela signifie que la vitesse provient du système d'exploitation (peut-être fournie par le matériel tactile ou le pilote). Mais généralement, la capacité « Velocity » n'est pas activée, ce qui indique que la vitesse est calculée par Qt, à l'aide d'un simple filtre de Kalman, afin de fournir une vitesse moyenne lissée plutôt qu'une valeur instantanée. Concrètement, cela indique à quelle vitesse et dans quelle direction l'utilisateur a fait glisser ce point au cours des derniers événements, l'événement le plus récent ayant la plus forte influence.
Fonctions d’accès :
| QVector2D | velocity() const |
Voir également QInputDevice::capabilities() et QInputEvent::device().
Documentation des fonctions membres
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Crée un point d'événement avec les valeurs suivantes : pointId, state, scenePosition et globalPosition.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Crée un point d'événement en effectuant une copie superficielle de other.
[constexpr noexcept default] QEventPoint::QEventPoint(QEventPoint &&other)
Crée un point d'événement en déplaçant other.
[noexcept] QEventPoint::~QEventPoint()
Supprime le point d'événement.
QPointF QEventPoint::normalizedPosition() const
Renvoie la position normalisée de ce point.
Les coordonnées sont calculées en transformant globalPosition() dans l'espace de QInputDevice::availableVirtualGeometry(), c'est-à-dire que (0, 0) correspond au coin supérieur gauche et (1, 1) au coin inférieur droit.
Voir également globalPosition.
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
Renvoie « true » si ce point d'événement n'est pas égal à « other » ; sinon, renvoie « false ».
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
Cette instruction attribue la variable « other » à cette instance de point d'événement.
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Attribue la variable ` other ` à ce point d'événement et renvoie une référence à ce point d'événement.
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
Renvoie « true » si ce point d'événement est égal à « other », sinon renvoie « false ».
© 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.
