Obsolete Members for QMouseEvent

The following members of class QMouseEvent are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

Public Functions

Member Function Documentation

QPoint QMouseEvent::globalPos() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use globalPosition().toPoint() instead.

Returns the global position of the mouse cursor at the time of the event. This is important on asynchronous window systems like X11. Whenever you move your widgets around in response to mouse events, globalPos() may differ a lot from the current pointer position QCursor::pos(), and from QWidget::mapToGlobal(pos()).

See also globalX() and globalY().

int QMouseEvent::globalX() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use globalPosition().x() instead.

Returns the global x position of the mouse cursor at the time of the event.

See also globalY() and globalPos().

int QMouseEvent::globalY() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use globalPosition().y() instead.

Returns the global y position of the mouse cursor at the time of the event.

See also globalX() and globalPos().

[since 5.0] QPointF QMouseEvent::localPos() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use position() instead.

Returns the position of the mouse cursor as a QPointF, relative to the widget or item that received the event.

If you move the widget as a result of the mouse event, use the screen position returned by screenPos() to avoid a shaking motion.

This function was introduced in Qt 5.0.

See also x(), y(), windowPos(), and screenPos().

[since 5.0] QPointF QMouseEvent::screenPos() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use globalPosition() instead.

Returns the position of the mouse cursor as a QPointF, relative to the screen that received the event.

This function was introduced in Qt 5.0.

See also x(), y(), pos(), localPos(), and windowPos().

[since 5.3] Qt::MouseEventSource QMouseEvent::source() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use pointingDevice() instead.

Returns information about the mouse event source.

The mouse event source can be used to distinguish between genuine and artificial mouse events. The latter are events that are synthesized from touch events by the operating system or Qt itself. This enum tells you from where it was synthesized; but often it's more useful to know from which device it was synthesized, so try to use pointingDevice() instead.

Note: Many platforms provide no such information. On such platforms Qt::MouseEventNotSynthesized is returned always.

This function was introduced in Qt 5.3.

See also Qt::MouseEventSource and QGraphicsSceneMouseEvent::source().

[since 5.0] QPointF QMouseEvent::windowPos() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use scenePosition() instead.

Returns the position of the mouse cursor as a QPointF, relative to the window that received the event.

If you move the widget as a result of the mouse event, use the global position returned by globalPos() to avoid a shaking motion.

This function was introduced in Qt 5.0.

See also x(), y(), pos(), localPos(), and screenPos().

int QMouseEvent::x() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use position().x() instead.

Returns the x position of the mouse cursor, relative to the widget that received the event.

See also y() and pos().

int QMouseEvent::y() const

This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Use position().y() instead.

Returns the y position of the mouse cursor, relative to the widget that received the event.

See also x() and pos().