Obsolete Members for QMouseEvent

Los siguientes miembros de la clase QMouseEvent son obsoletos. Se proporcionan para que el código fuente antiguo siga funcionando. Desaconsejamos su uso en código nuevo.

Funciones públicas

Documentación de funciones 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. Desaconsejamos su uso en código nuevo.

Utilice otro constructor en su lugar (se requiere la posición global).

Construye un objeto de evento de ratón originado en 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 relativa al widget o elemento receptor. La posición de la ventana se establece en el mismo valor que localPos. El button que causó el evento se da como un valor del enum Qt::MouseButton. Si el evento type es MouseMove, el botón apropiado 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.

El constructor globalPosition() se inicializa a QCursor::pos(), que puede no ser apropiado. Utiliza el otro constructor para especificar explícitamente la posición global.

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice globalPosition().toPoint() en su lugar.

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 de 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. Desaconsejamos su uso en código nuevo.

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

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

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

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice globalPosition().y() en su lugar.

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

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

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice position() en su lugar.

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

Si mueves el widget como resultado del evento del ratón, utiliza la posición de pantalla devuelta por screenPos() para evitar un movimiento brusco.

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. Desaconsejamos su uso en código nuevo.

Utilice position() en su lugar.

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

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

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. Desaconsejamos su uso en código nuevo.

Utilice globalPosition() en su lugar.

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

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

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice pointingDevice() en su lugar.

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

La fuente de eventos de ratón se puede utilizar para distinguir entre eventos de ratón genuinos y artificiales. Estos últimos son eventos sintetizados a partir de eventos táctiles por el sistema operativo o el propio Qt. Este enum te dice desde dónde fue sintetizado; pero a menudo es más útil saber desde qué dispositivo fue sintetizado, así que intenta usar pointingDevice() en su lugar.

Ver 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. Desaconsejamos su uso en código nuevo.

Utilice scenePosition() en su lugar.

Devuelve la posición del cursor del ratón como QPointF, relativa a la ventana que recibió el evento.

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

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. Desaconsejamos su uso en código nuevo.

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

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. Desaconsejamos su uso en código nuevo.

Utilice position().y() en su lugar.

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

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