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. En savoir plus...

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 de : 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

Fonctions protégées

QSinglePointEvent(QSinglePointEvent &&)
QSinglePointEvent &operator=(QSinglePointEvent &&)
QSinglePointEvent &operator=(const QSinglePointEvent &other)

Description détaillée

Documentation sur les propriétés

exclusivePointGrabber : QObject*

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

Le « grabber exclusif » est un objet qui a choisi de recevoir tous les futurs événements de mise à jour ainsi que l'événement de libération contenant le même point que celui porté par cet événement.

La définition de la propriété `exclusivePointGrabber` est un raccourci équivalent à :

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

Fonctions d'accès :

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

Documentation des fonctions membres

[protected delete] QSinglePointEvent::QSinglePointEvent(QSinglePointEvent &&)

Crée par « move » une instance de ` QSinglePointEvent`. Cette fonction est supprimée.

Qt::MouseButton QSinglePointEvent::button() const

Renvoie le bouton à l'origine de 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 au moment où l'événement a été généré.

L'état du bouton est une combinaison des événements « Qt::LeftButton », « Qt::RightButton » et « Qt::MiddleButton » à l'aide de l'opérateur OU.

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 « pression de la souris », « double-clic » ou « TabletPress », cela inclut le bouton à l’origine de l’événement.

Pour les événements de relâchement de la souris ou d'TabletRelease, cela exclut le bouton qui a provoqué l'événement.

Voir également ` button()`.

QPointF QSinglePointEvent::globalPosition() const

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

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

Voir également position().

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

Renvoie « true » si cet événement correspond à l'button.

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

Renvoie « true » si cet événement correspond à la libération d'un « button ».

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

Renvoie « true » si cet événement n'implique pas de modification de l'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 la fonction 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 également QEventPoint::scenePosition.

[protected delete] QSinglePointEvent &QSinglePointEvent::operator=(QSinglePointEvent &&)

La commande « Move » attribue « other » à cette instance « QSinglePointEvent ». Cette fonction est supprimée.

[noexcept protected default] QSinglePointEvent &QSinglePointEvent::operator=(const QSinglePointEvent &other)

Attribue par copie l'other à cette instance d'QSinglePointEvent.

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