Sur cette page

QSinglePointEvent Class

Classe de base pour les événements de pointeur contenant un seul point, tels que les événements de souris. Plus d'informations...

En-tête : #include <QSinglePointEvent>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Depuis : Qt 6.0
Hérite : QPointerEvent
Hérité par :

QEnterEvent, QHoverEvent, QMouseEvent, QNativeGestureEvent, QTabletEvent, et QWheelEvent

Propriétés

Fonctions publiques

Qt::MouseButton button() const
Qt::MouseButtons buttons() const
QObject *exclusivePointGrabber() const
QPointF globalPosition() const
QPointF position() const
QPointF scenePosition() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Fonctions publiques réimplémentées

virtual bool isBeginEvent() const override
virtual bool isEndEvent() const override
virtual bool isUpdateEvent() const override

Description détaillée

Documentation sur les propriétés

exclusivePointGrabber : QObject*

Cette propriété indique l'objet qui recevra les futures mises à jour

Le capteur exclusif est un objet qui a choisi de recevoir tous les événements de mise à jour futurs et l'événement de diffusion contenant le même point que cet événement.

La définition de la propriété exclusivePointGrabber est équivalente à la définition de la propriété exclusivePointGrabber :

setExclusiveGrabber(points().first(), exclusiveGrabber);

Accéder aux fonctions :

QObject *exclusivePointGrabber() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Fonction membre Documentation

Qt::MouseButton QSinglePointEvent::button() const

Renvoie le bouton qui a provoqué l'événement.

La valeur renvoyée est toujours Qt::NoButton pour les événements de déplacement de la souris, ainsi que pour les événements TabletMove, TabletEnterProximity et TabletLeaveProximity.

Voir également buttons().

Qt::MouseButtons QSinglePointEvent::buttons() const

Renvoie l'état du bouton lorsque l'événement a été généré.

L'état du bouton est une combinaison de Qt::LeftButton, Qt::RightButton, et Qt::MiddleButton en utilisant l'opérateur OR.

Pour les événements de déplacement de la souris ou TabletMove, il s'agit de tous les boutons enfoncés.

Pour les événements de pression de la souris, de double clic ou TabletPress, il s'agit du bouton qui a provoqué l'événement.

Pour les événements de relâchement de la souris ou TabletRelease, le bouton à l'origine de l'événement est exclu.

Voir également button().

QPointF QSinglePointEvent::globalPosition() const

Renvoie la position du point dans cet événement sur l'écran ou le bureau virtuel.

Remarque : la position globale d'un pointeur de souris est enregistrée au moment de l'événement. Ceci est important sur les systèmes de fenêtres asynchrones tels que X11 ; lorsque vous déplacez vos widgets en réponse aux événements de la souris, globalPosition() peut être très différent de la position actuelle du curseur renvoyée par QCursor::pos().

Voir aussi position().

[override virtual] bool QSinglePointEvent::isBeginEvent() const

Renvoie true si cet événement représente une pression sur button.

[override virtual] bool QSinglePointEvent::isEndEvent() const

Renvoie true si cet événement représente une libération de button.

[override virtual] bool QSinglePointEvent::isUpdateEvent() const

Renvoie true si cet événement ne comporte pas de modification de button state.

QPointF QSinglePointEvent::position() const

Renvoie la position du point dans cet événement, par rapport au widget ou à l'élément qui a reçu l'événement.

Si vous déplacez vos widgets en réponse à des événements de souris, utilisez plutôt globalPosition().

Voir également globalPosition().

QPointF QSinglePointEvent::scenePosition() const

Renvoie la position du point dans cet événement, par rapport à la fenêtre ou à la scène.

Voir aussi QEventPoint::scenePosition.

© 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.