Obsolete Members for QMouseEvent

Los siguientes miembros de la clase ` QMouseEvent ` están obsoletos. Se proporcionan para garantizar que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.

Funciones públicas

(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

Documentación de las funciones de miembro

[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())

Esta función está obsoleta desde la versión 6.4. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza otro constructor en su lugar (se requiere una posición global).

Crea un objeto de evento de ratón procedente de device.

El parámetro « type » debe ser uno de los siguientes: « QEvent::MouseButtonPress », « QEvent::MouseButtonRelease », « QEvent::MouseButtonDblClick » o « QEvent::MouseMove ».

localPos es la posición del cursor del ratón con respecto al widget o elemento receptor. La posición de la ventana se establece en el mismo valor que localPos. El button que provocó el evento se indica como un valor de la enumeración Qt::MouseButton. Si el evento type es MouseMove, el botón adecuado para este evento es Qt::NoButton. Los estados del ratón y del teclado en el momento del evento se especifican mediante buttons y modifiers.

La función ` globalPosition()` se inicializa con ` QCursor::pos()`, lo que puede no ser adecuado. Utiliza el otro constructor para especificar la posición global de forma explícita.

[deprecated in 6.0] QPoint QMouseEvent::globalPos() const

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` globalPosition()`.

Devuelve la posición global del cursor del ratón en el momento del evento. Esto es importante en sistemas de ventanas asíncronos como X11. Siempre que muevas tus widgets en respuesta a eventos del ratón, globalPos() puede diferir mucho de la posición actual del puntero QCursor::pos() y de QWidget::mapToGlobal(pos()).

Véase también globalX() y globalY().

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar globalPosition().x().

Devuelve la posición x global del cursor del ratón en el momento del evento.

Véanse también ` globalY()` y ` globalPos()`.

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` globalPosition()`. `y()`.

Devuelve la posición global en el eje Y del cursor del ratón en el momento del evento.

Véanse también globalX() y globalPos().

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` position()`.

Devuelve la posición del cursor del ratón como un objeto ` QPointF`, relativa al widget o elemento que recibió el evento.

Si se desplaza el widget como consecuencia del evento del ratón, utilice la posición en pantalla devuelta por screenPos() para evitar un movimiento tembloroso.

Véase también x(), y(), windowPos() y screenPos().

[deprecated in 6.0] QPoint QMouseEvent::pos() const

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` position()`.

Devuelve la posición del cursor del ratón, relativa al widget que recibió el evento.

Si mueves el widget como consecuencia del evento del ratón, utiliza la posición global devuelta por globalPos() para evitar un movimiento tembloroso.

Véase también ` x()`, ` y()` y ` globalPos()`.

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` globalPosition()`.

Devuelve la posición del cursor del ratón como un objeto ` QPointF`, relativa a la pantalla que recibió el evento.

Véanse también x(), y(), pos(), localPos() y windowPos().

[deprecated in 6.0] Qt::MouseEventSource QMouseEvent::source() const

Esta función ha quedado obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` pointingDevice()`.

Devuelve información sobre el origen del evento del ratón.

El origen del evento del ratón se puede utilizar para distinguir entre eventos del ratón auténticos y artificiales. Estos últimos son eventos sintetizados a partir de eventos táctiles por el sistema operativo o por el propio Qt. Esta enumeración indica de dónde se ha sintetizado; sin embargo, a menudo resulta más útil saber desde qué dispositivo se ha sintetizado, por lo que se recomienda utilizar pointingDevice() en su lugar.

Nota: Muchas plataformas no proporcionan este tipo de información. En dichas plataformas, siempre se devuelve ` Qt::MouseEventNotSynthesized `.

Nota: En el código basado en Qt 5, se solía utilizar `source()` para intentar distinguir los eventos de ratón procedentes de un ratón real de aquellos que se sintetizaban porque alguna subclase heredada de ` QQuickItem ` o ` QWidget ` no reaccionaba a un ` QTouchEvent`. Sin embargo, no se podía determinar si se había sintetizado a partir de un ` QTouchEvent ` o un ` QTabletEvent`, y se perdía otra información. ` pointingDevice` () indica el dispositivo específico del que procede, por lo que puedes consultar pointingDevice()->type() o pointingDevice()->capabilities() para decidir cómo reaccionar ante este evento. Pero es aún mejor reaccionar ante el evento original en lugar de gestionar únicamente los eventos del ratón.

Véase también Qt::MouseEventSource y QGraphicsSceneMouseEvent::source().

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` scenePosition()`.

Devuelve la posición del cursor del ratón como un objeto de tipo « QPointF », relativa a la ventana que recibió el evento.

Si mueves el widget como consecuencia del evento del ratón, utiliza la posición global devuelta por globalPos() para evitar un movimiento tembloroso.

Véase también x(), y(), pos(), localPos() y screenPos().

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar position().x().

Devuelve la posición x del cursor del ratón, relativa al widget que recibió el evento.

Véase también ` y()` y ` pos()`.

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` position().y()`.

Devuelve la posición y del cursor del ratón, relativa al widget que recibió el evento.

Véase también ` x()` y ` pos()`.

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