Obsolete Members for QMouseEvent

Die folgenden Mitglieder der Klasse QMouseEvent sind veraltet. Sie werden bereitgestellt, um alten Quellcode funktionsfähig zu halten. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Funktionen

Dokumentation der Mitgliedsfunktionen

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

Diese Funktion ist seit 6.4 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen einen anderen Konstruktor (globale Position ist erforderlich).

Konstruiert ein Mausereignisobjekt, das von device stammt.

Der Parameter type muss einer der Parameter QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick oder QEvent::MouseMove sein.

localPos ist die Position des Mauszeigers relativ zu dem empfangenden Widget oder Element. Die Fensterposition wird auf denselben Wert wie localPos gesetzt. Das button, das das Ereignis ausgelöst hat, wird als Wert aus der Aufzählung Qt::MouseButton angegeben. Wenn das Ereignis type MouseMove ist, ist die entsprechende Schaltfläche für dieses Ereignis Qt::NoButton. Die Maus- und Tastaturzustände zum Zeitpunkt des Ereignisses werden durch buttons und modifiers angegeben.

globalPosition() wird auf QCursor::pos() initialisiert, was möglicherweise nicht angemessen ist. Verwenden Sie den anderen Konstruktor, um die globale Position explizit anzugeben.

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen globalPosition().toPoint().

Gibt die globale Position des Mauszeigers zum Zeitpunkt des Ereignisses zurück. Dies ist auf asynchronen Fenstersystemen wie X11 wichtig. Wenn Sie Ihre Widgets als Reaktion auf Mausereignisse verschieben, kann globalPos() stark von der aktuellen Mauszeigerposition QCursor::pos() und von QWidget::mapToGlobal(pos()) abweichen.

Siehe auch globalX() und globalY().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen globalPosition().x().

Gibt die globale x-Position des Mauszeigers zum Zeitpunkt des Ereignisses zurück.

Siehe auch globalY() und globalPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen globalPosition().y().

Gibt die globale y-Position des Mauszeigers zum Zeitpunkt des Ereignisses zurück.

Siehe auch globalX() und globalPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen position().

Gibt die Position des Mauszeigers als QPointF zurück, relativ zu dem Widget oder Element, das das Ereignis empfangen hat.

Wenn Sie das Widget als Folge des Mausereignisses verschieben, verwenden Sie die von screenPos() zurückgegebene Bildschirmposition, um eine wackelnde Bewegung zu vermeiden.

Siehe auch x(), y(), windowPos(), und screenPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen position().

Gibt die Position des Mauszeigers zurück, relativ zu dem Widget, das das Ereignis empfangen hat.

Wenn Sie das Widget als Folge des Mausereignisses bewegen, verwenden Sie die globale Position, die von globalPos() zurückgegeben wird, um eine wackelnde Bewegung zu vermeiden.

Siehe auch x(), y(), und globalPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen globalPosition().

Gibt die Position des Mauszeigers als QPointF zurück, relativ zu dem Bildschirm, der das Ereignis empfangen hat.

Siehe auch x(), y(), pos(), localPos(), und windowPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen pointingDevice().

Gibt Informationen über die Quelle des Mausereignisses zurück.

Die Mausereignisquelle kann verwendet werden, um zwischen echten und künstlichen Mausereignissen zu unterscheiden. Letztere sind Ereignisse, die vom Betriebssystem oder von Qt selbst aus Berührungsereignissen synthetisiert werden. Diese Aufzählung sagt Ihnen, woher es synthetisiert wurde; aber oft ist es nützlicher zu wissen, von welchem Gerät es synthetisiert wurde, also versuchen Sie stattdessen pointingDevice() zu verwenden.

Siehe auch Qt::MouseEventSource und QGraphicsSceneMouseEvent::source().

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

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen scenePosition().

Gibt die Position des Mauszeigers als QPointF zurück, relativ zu dem Fenster, das das Ereignis empfangen hat.

Wenn Sie das Widget als Folge des Mausereignisses bewegen, verwenden Sie die globale Position, die von globalPos() zurückgegeben wird, um eine wackelnde Bewegung zu vermeiden.

Siehe auch x(), y(), pos(), localPos(), und screenPos().

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

Diese Funktion ist seit 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen position().x().

Gibt die x-Position des Mauszeigers zurück, relativ zu dem Widget, das das Ereignis empfangen hat.

Siehe auch y() und pos().

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

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen position().y().

Gibt die y-Position des Mauszeigers zurück, relativ zu dem Widget, das das Ereignis empfangen hat.

Siehe auch x() und pos().