Obsolete Members for QMouseEvent

Les membres suivants de la classe QMouseEvent sont obsolètes. Ils sont fournis pour permettre aux anciens codes sources de continuer à fonctionner. Il est fortement déconseillé de les utiliser dans un nouveau code.

Fonctions publiques

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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt un autre constructeur (la position globale est requise).

Construit un objet d'événement de souris provenant de device.

Le paramètre type doit être l'un des suivants : QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick, ou QEvent::MouseMove.

Le paramètre 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 fixée à la même valeur que localPos. L'adresse button qui a provoqué l'événement est donnée comme une valeur de l'énumération Qt::MouseButton. Si l'événement type est MouseMove, le bouton approprié pour 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 valeur de globalPosition() est initialisée à QCursor::pos(), ce qui peut ne pas être 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt globalPosition().toPoint().

Renvoie la position globale du curseur de la souris au moment de l'événement. Ceci est important pour les systèmes de fenêtres asynchrones comme X11. Lorsque vous déplacez vos widgets en réponse aux événements de la souris, globalPos() peut être très différent 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt globalPosition().x().

Renvoie la position x globale du curseur de la souris au moment de l'événement.

Voir aussi globalY() et globalPos().

[deprecated in 6.0] int QMouseEvent::globalY() const

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt globalPosition().y().

Renvoie la position globale en y du curseur de la souris au moment de l'événement.

Voir aussi globalX() et globalPos().

[deprecated in 6.0] QPointF QMouseEvent::localPos() const

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt position().

Renvoie la position du curseur de la souris sous forme de QPointF, par rapport au widget ou à l'élément qui a reçu l'événement.

Si vous déplacez le widget à la suite de l'événement de la souris, utilisez la position de l'écran renvoyée par screenPos() pour éviter un mouvement de tremblement.

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. Il est fortement déconseillé de l'utiliser dans un 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 de l'événement souris, utilisez la position globale renvoyée par globalPos() pour éviter un mouvement de tremblement.

Voir aussi x(), y() et globalPos().

[deprecated in 6.0] QPointF QMouseEvent::screenPos() const

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt globalPosition().

Renvoie la position du curseur de la souris sous forme de QPointF, par rapport à l'écran qui a reçu l'événement.

Voir aussi 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt pointingDevice().

Renvoie des informations sur la source de l'événement souris.

La source de l'événement souris peut être utilisée pour distinguer les événements souris authentiques des événements souris artificiels. Ces derniers sont des événements synthétisés à partir des événements tactiles par le système d'exploitation ou Qt lui-même. Cette énumération vous indique la source de l'événement ; mais il est souvent plus utile de savoir à partir de quel périphérique il a été synthétisé, alors essayez d'utiliser pointingDevice() à la place.

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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt scenePosition().

Renvoie la position du curseur de la souris sous forme de QPointF, par rapport à la fenêtre qui a reçu l'événement.

Si vous déplacez le widget à la suite de l'événement souris, utilisez la position globale renvoyée par globalPos() pour éviter un mouvement de tremblement.

Voir aussi x(), y(), pos(), localPos() et screenPos().

[deprecated in 6.0] int QMouseEvent::x() const

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un 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.

Voir aussi y() et pos().

[deprecated in 6.0] int QMouseEvent::y() const

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un 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.

Voir aussi x() et pos().