QEventPoint Class
La classe QEventPoint fournit des informations sur un point dans un site QPointerEvent. 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 des types de membres
enum QEventPoint::State
flags QEventPoint::States
Spécifie l'état de ce point d'événement.
| Constante | Valeur | Description de l'état |
|---|---|---|
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 est 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 un typedef pour QFlags<State>. Il stocke une combinaison OU de valeurs d'état.
Documentation sur les 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.
Sur Qt Quick cependant, il est normal qu'un élément ou un gestionnaire d'événements n'accepte que les points individuels d'un QTouchEvent qui participent effectivement à un geste, tandis que les autres points peuvent être transmis à d'autres éléments ou à d'autres gestionnaires. Par souci de cohérence, cela s'applique à tout QPointerEvent; et la livraison n'est effectuée que lorsque tous les points d'un 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 dispositif de pointage à partir duquel ce point d'événement a été créé.
Fonctions d'accès :
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Cette propriété indique la largeur et la hauteur de l'ellipse de délimitation du point de contact.
La valeur de retour est exprimée en pixels logiques. La plupart des écrans tactiles ne détectent pas la forme du point de contact, et aucune souris ou tablette ne peut la détecter, de sorte qu'une taille nulle est la valeur la plus courante. Sur certains écrans tactiles, les diamètres peuvent être non nuls et toujours égaux (l'ellipse est assimilée à 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é saisi.
La position globale est relative à l'écran ou au bureau virtuel.
Fonctions d'accès :
| QPointF | globalGrabPosition() const |
Voir aussi globalPosition, grabPosition, et sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Cette propriété contient la position globale de ce point à partir 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 aussi globalPressPosition, position, et scenePosition.
[read-only] globalPressPosition : const QPointF
Cette propriété contient la position globale à laquelle ce point a été pressé.
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é indique la position à laquelle ce point a été saisi.
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.
Note : Ne pas supposer que les numéros d'identification commencent à zéro ou qu'ils sont séquentiels. Une telle hypothèse est souvent fausse en raison de la manière dont les pilotes sous-jacents fonctionnent.
Fonctions d'accès :
| int | id() const |
[read-only] lastPosition : const QPointF
Cette propriété contient la position de ce point depuis 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 du précédent QPointerEvent 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é pressé.
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 point a été pressé.
Fonctions d'accès :
| ulong | pressTimestamp() const |
Voir aussi timestamp.
[read-only] pressure : const qreal
Cette propriété contient la pression de ce point.
La valeur de retour est comprise entre 0.0 et 1.0.
Fonctions d'accès :
| qreal | pressure() const |
[read-only] rotation : const qreal
Cette propriété indique l'orientation angulaire de ce point.
La valeur de retour est exprimée en degrés, où zéro (valeur par défaut) indique que le doigt, le jeton ou le stylet pointe vers le haut, un angle négatif signifie qu'il a pivoté vers la gauche et un angle positif signifie qu'il a pivoté vers la droite. La plupart des écrans tactiles ne détectent pas la rotation, de sorte que zéro est la valeur la plus courante.
Fonctions d'accès :
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Cette propriété contient la position de la scène à laquelle ce point a été saisi.
La position de la scène est la position relative à QQuickWindow si elle est gérée dans QQuickItem::event(), en coordonnées QGraphicsScene si elle est gérée par une surcharge de QGraphicsItem::touchEvent(), ou la position de la fenêtre dans les applications de widget.
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 scène de ce point depuis l'événement de pression ou de déplacement précédent.
La position de la scène est la position relative à QQuickWindow si elle est gérée dans QQuickItem::event(), en coordonnées QGraphicsScene si elle est gérée par une surcharge de QGraphicsItem::touchEvent(), ou la position de la fenêtre dans les applications de 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 sur la scène.
La position de la scène est la position relative à QQuickWindow si elle est gérée dans QQuickItem::event(), en coordonnées QGraphicsScene si elle est gérée par une surcharge de QGraphicsItem::touchEvent(), ou la position de la fenêtre dans les applications de widget.
Fonctions d'accès :
| QPointF | scenePosition() const |
Voir également scenePressPosition, position, et globalPosition.
[read-only] scenePressPosition : const QPointF
Cette propriété contient la position de la scène à laquelle ce point a été pressé.
La position de la scène est la position relative à QQuickWindow si elle est gérée dans QQuickItem::event(), en coordonnées QGraphicsScene si elle est gérée par une surcharge de QGraphicsItem::touchEvent(), ou la position de la fenêtre dans les applications de widget.
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, depuis que ce point a été pressé et non 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 également 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 les doigts de manière unique.
Lorsqu'il provient d'un QTabletEvent, il identifie le numéro de série du stylet utilisé.
Il peut identifier un jeton spécifique (objet fiducial) 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, en unités de pixels par seconde, dans le système de coordonnées de l'écran ou du bureau.
Note : Si les capacités du périphérique incluent QInputDevice::Velocity, cela signifie que la vitesse provient du système d'exploitation (peut-être que le matériel tactile ou le pilote le fournit). Mais en général, la capacité Velocity n'est pas activée, ce qui indique que la vitesse est calculée par Qt XML, à l'aide d'un simple filtre de Kalman pour fournir une vitesse moyenne lissée plutôt qu'une valeur instantanée. En fait, 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 l'influence la plus forte.
Fonctions d'accès :
| QVector2D | velocity() const |
Voir également QInputDevice::capabilities() et QInputEvent::device().
Documentation sur les fonctions membres
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Construit un point d'événement avec les données pointId, state, scenePosition et globalPosition.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Construit un point d'événement en faisant une copie superficielle de other.
[constexpr noexcept] QEventPoint::QEventPoint(QEventPoint &&other)
Construit un point d'événement en déplaçant other.
[noexcept] QEventPoint::~QEventPoint()
Détruit 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) est le coin supérieur gauche et (1, 1) est le coin inférieur droit.
Voir aussi 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)
Move-assigne other à cette instance de point d'événement.
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Attribue 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.
