Obsolete Members for QMouseEvent
Les membres suivants de la classe ` QMouseEvent ` sont obsolètes. Ils sont fournis afin de garantir la compatibilité avec l'ancien code source. Nous déconseillons fortement de les utiliser dans du nouveau code.
Fonctions publiques
(deprecated in 6.4) | QMouseEvent(QEvent::Type type, const QPointF &localPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) |
(deprecated in 6.0) QPoint | globalPos() const |
(deprecated in 6.0) int | globalX() const |
(deprecated in 6.0) int | globalY() const |
(deprecated in 6.0) QPointF | localPos() const |
(deprecated in 6.0) QPoint | pos() const |
(deprecated in 6.0) QPointF | screenPos() const |
(deprecated in 6.0) Qt::MouseEventSource | source() const |
(deprecated in 6.0) QPointF | windowPos() const |
(deprecated in 6.0) int | x() const |
(deprecated in 6.0) int | y() const |
Documentation des fonctions membres
[deprecated in 6.4] QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
Cette fonction est obsolète depuis la version 6.4. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt un autre constructeur (la position globale est obligatoire).
Crée un objet d'événement de souris provenant de device.
Le paramètre ` type ` doit prendre l'une des valeurs suivantes : ` QEvent::MouseButtonPress`, ` QEvent::MouseButtonRelease`, ` QEvent::MouseButtonDblClick` ou ` QEvent::MouseMove`.
localPos correspond à la position du curseur de la souris par rapport au widget ou à l’élément récepteur. La position de la fenêtre est définie sur la même valeur que localPos. L’ button à l’origine de l’événement est indiquée par une valeur issue de l’énumération Qt::MouseButton. Si l’événement type est MouseMove, le bouton correspondant à cet événement est Qt::NoButton. Les états de la souris et du clavier au moment de l’événement sont spécifiés par buttons et modifiers.
La méthode ` globalPosition()` est initialisée à ` QCursor::pos()`, ce qui n'est pas forcément approprié. Utilisez l'autre constructeur pour spécifier explicitement la position globale.
[deprecated in 6.0] QPoint QMouseEvent::globalPos() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` globalPosition()`.
Renvoie la position globale du curseur de la souris au moment de l’événement. Ceci est important sur les systèmes de fenêtrage asynchrones tels que X11. Chaque fois que vous déplacez vos widgets en réponse à des événements de souris, globalPos() peut différer considérablement de la position actuelle du pointeur QCursor::pos() et de QWidget::mapToGlobal(pos()).
Voir également globalX() et globalY().
[deprecated in 6.0] int QMouseEvent::globalX() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` globalPosition()` ou `x()`.
Renvoie la position x globale du curseur de la souris au moment de l'événement.
Voir également globalY() et globalPos().
[deprecated in 6.0] int QMouseEvent::globalY() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt globalPosition().y().
Renvoie la position y globale du curseur de la souris au moment de l'événement.
Voir également globalX() et globalPos().
[deprecated in 6.0] QPointF QMouseEvent::localPos() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` position()`.
Renvoie la position du curseur de la souris sous la forme d'un objet QPointF, par rapport au widget ou à l'élément ayant reçu l'événement.
Si vous déplacez le widget à la suite d'un événement de souris, utilisez la position à l'écran renvoyée par screenPos() pour éviter un mouvement saccadé.
Voir également x(), y(), windowPos() et screenPos().
[deprecated in 6.0] QPoint QMouseEvent::pos() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` position()`.
Renvoie la position du curseur de la souris, par rapport au widget qui a reçu l'événement.
Si vous déplacez le widget à la suite d'un événement de souris, utilisez la position globale renvoyée par globalPos() pour éviter un mouvement saccadé.
Voir également x(), y() et globalPos().
[deprecated in 6.0] QPointF QMouseEvent::screenPos() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons vivement de l'utiliser dans du nouveau code.
Utilisez plutôt ` globalPosition()`.
Renvoie la position du curseur de la souris sous la forme d'une coordonnée « QPointF », par rapport à l'écran ayant reçu l'événement.
Voir également x(), y(), pos(), localPos() et windowPos().
[deprecated in 6.0] Qt::MouseEventSource QMouseEvent::source() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt pointingDevice().
Renvoie des informations sur la source de l'événement souris.
La source de l'événement de souris peut être utilisée pour distinguer les événements de souris authentiques des événements artificiels. Ces derniers sont des événements synthétisés à partir d'événements tactiles par le système d'exploitation ou par Qt lui-même. Cette énumération vous indique d'où provient la synthèse ; mais il est souvent plus utile de savoir à partir de quel périphérique elle a été effectuée. Essayez donc d'utiliser pointingDevice() à la place.
Remarque : de nombreuses plateformes ne fournissent pas ce type d’informations. Sur ces plateformes, la fonction ` Qt::MouseEventNotSynthesized ` renvoie toujours la même valeur.
Remarque : dans le code basé sur Qt 5, la fonction `source()` était souvent utilisée pour tenter de distinguer les événements de souris provenant d’une souris physique de ceux qui étaient synthétisés, car certaines sous-classes héritées de ` QQuickItem ` ou ` QWidget ` ne réagissaient pas à ` QTouchEvent`. Cependant, il était impossible de savoir s’ils provenaient d’un ` QTouchEvent ` ou d’un ` QTabletEvent`, et d’autres informations étaient perdues. ` pointingDevice` () vous indique le périphérique spécifique d'où provient l'événement ; vous pouvez donc consulter pointingDevice()->type() ou pointingDevice()->capabilities() pour décider comment réagir à cet événement. Mais il est encore préférable de réagir à l'événement d'origine plutôt que de ne gérer que les événements de souris.
Voir également Qt::MouseEventSource et QGraphicsSceneMouseEvent::source().
[deprecated in 6.0] QPointF QMouseEvent::windowPos() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` scenePosition()`.
Renvoie la position du curseur de la souris sous la forme d'un objet ` QPointF`, par rapport à la fenêtre qui a reçu l'événement.
Si vous déplacez le widget à la suite d’un événement de souris, utilisez la position globale renvoyée par globalPos() pour éviter tout mouvement saccadé.
Voir également x(), y(), pos(), localPos() et screenPos().
[deprecated in 6.0] int QMouseEvent::x() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` position().x()`.
Renvoie la position x du curseur de la souris, par rapport au widget qui a reçu l'événement.
[deprecated in 6.0] int QMouseEvent::y() const
Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Utilisez plutôt ` position().y()`.
Renvoie la position y du curseur de la souris, par rapport au widget qui a reçu l'événement.
© 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.