Obsolete Members for QMouseEvent
Die folgenden Mitglieder der Klasse „ QMouseEvent “ sind veraltet. Sie werden bereitgestellt, um die Funktionsfähigkeit von altem Quellcode zu gewährleisten. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Funktionen
(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 |
Dokumentation zu 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 Version 6.4 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen einen anderen Konstruktor (die globale Position ist erforderlich).
Erstellt ein Mausereignisobjekt, das von device stammt.
Der Parameter „ type “ muss einer der folgenden Werte sein: „ QEvent::MouseButtonPress “, „ QEvent::MouseButtonRelease “, „ QEvent::MouseButtonDblClick “ oder „ QEvent::MouseMove “.
localPos ist die Position des Mauszeigers relativ zum 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 Enumeration Qt::MouseButton angegeben. Wenn das Ereignis type MouseMove ist, lautet die entsprechende Schaltfläche für dieses Ereignis Qt::NoButton. Der Maus- und Tastaturstatus zum Zeitpunkt des Ereignisses wird durch buttons und modifiers angegeben.
Die Methode „ globalPosition()“ wird mit „ 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 Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen ` globalPosition()`.
Gibt die globale Position des Mauszeigers zum Zeitpunkt des Ereignisses zurück. Dies ist bei asynchronen Fenstersystemen wie X11 wichtig. Immer wenn Sie Ihre Widgets als Reaktion auf Mausereignisse verschieben, kann sich globalPos() erheblich von der aktuellen Zeigerposition ( QCursor::pos) sowie von QWidget::mapToGlobal(pos) unterscheiden.
Siehe auch ` globalX()` und ` globalY()`.
[deprecated in 6.0] int QMouseEvent::globalX() const
Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen „ globalPosition()“ und „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 Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen „ globalPosition()“ und „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 Version 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 infolge des Mausereignisses verschieben, verwenden Sie die von ` screenPos()` zurückgegebene Bildschirmposition, um ein Ruckeln zu vermeiden.
Siehe auch x(), y(), windowPos() und screenPos().
[deprecated in 6.0] QPoint QMouseEvent::pos() const
Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen ` position()`.
Gibt die Position des Mauszeigers relativ zu dem Widget zurück, das das Ereignis empfangen hat.
Wenn Sie das Widget als Folge des Mausereignisses verschieben, verwenden Sie die von ` globalPos()` zurückgegebene globale Position, um ein Zittern zu vermeiden.
Siehe auch ` x()`, ` y()` und ` globalPos()`.
[deprecated in 6.0] QPointF QMouseEvent::screenPos() const
Diese Funktion ist seit Version 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 Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Verwenden Sie stattdessen ` pointingDevice()`.
Gibt Informationen zur 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 Enumeration gibt an, woher das Ereignis synthetisiert wurde; oft ist es jedoch nützlicher zu wissen, von welchem Gerät es synthetisiert wurde. Versuchen Sie daher stattdessen, ` pointingDevice()` zu verwenden.
Hinweis: Viele Plattformen stellen keine derartigen Informationen zur Verfügung. Auf solchen Plattformen wird immer ` Qt::MouseEventNotSynthesized ` zurückgegeben.
Hinweis: In Qt-5-basiertem Code wurde `source()` häufig verwendet, um zu versuchen, echte Mausereignisse von synthetisierten Ereignissen zu unterscheiden, die entstanden, weil eine ältere Unterklasse von ` QQuickItem ` oder ` QWidget ` nicht auf ` QTouchEvent` reagierte. Man konnte jedoch nicht erkennen, ob das Ereignis aus ` QTouchEvent ` oder ` QTabletEvent` synthetisiert wurde, und andere Informationen gingen verloren. ` pointingDevice` () gibt das konkrete Gerät an, von dem das Ereignis stammt. Sie können daher unter pointingDevice()->type() oder pointingDevice()->capabilities() nachsehen, wie Sie auf dieses Ereignis reagieren sollten. Es ist jedoch noch besser, auf das ursprüngliche Ereignis zu reagieren, anstatt nur Mausereignisse zu verarbeiten.
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` relativ zu dem Fenster zurück, das das Ereignis empfangen hat.
Wenn Sie das Widget infolge des Mausereignisses verschieben, verwenden Sie die von ` globalPos()` zurückgegebene globale Position, um ein Ruckeln zu vermeiden.
Siehe auch x(), y(), pos(), localPos() und screenPos().
[deprecated in 6.0] int QMouseEvent::x() const
Diese Funktion ist seit Version 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 relativ zu dem Widget zurück, 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 relativ zu dem Widget zurück, das das Ereignis empfangen hat.
© 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.