Auf dieser Seite

QSinglePointEvent Class

Eine Basisklasse für Zeigerereignisse, die einen einzelnen Punkt enthalten, wie beispielsweise Mausereignisse. Mehr...

Header: #include <QSinglePointEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Seit: Qt 6.0
Erbt von: QPointerEvent
Vererbt an:

QEnterEvent, QHoverEvent, QMouseEvent, QNativeGestureEvent, QTabletEvent sowie QWheelEvent

Eigenschaften

Öffentliche Funktionen

Qt::MouseButton button() const
Qt::MouseButtons buttons() const
QObject *exclusivePointGrabber() const
QPointF globalPosition() const
QPointF position() const
QPointF scenePosition() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Neu implementierte öffentliche Funktionen

virtual bool isBeginEvent() const override
virtual bool isEndEvent() const override
virtual bool isUpdateEvent() const override

Geschützte Funktionen

QSinglePointEvent(QSinglePointEvent &&)
QSinglePointEvent &operator=(QSinglePointEvent &&)
QSinglePointEvent &operator=(const QSinglePointEvent &other)

Ausführliche Beschreibung

Dokumentation zu Eigenschaften

exclusivePointGrabber : QObject*

Diese Eigenschaft enthält das Objekt, das zukünftige Aktualisierungen empfangen wird

Der „exclusive grabber“ ist ein Objekt, das sich dafür entschieden hat, alle zukünftigen Aktualisierungsereignisse sowie das Freigabeereignis zu empfangen, das denselben Punkt enthält wie dieses Ereignis.

Das Setzen der Eigenschaft „exclusivePointGrabber“ ist eine bequeme Alternative zu:

setExclusiveGrabber(points().first(), exclusiveGrabber);

Zugriffsfunktionen:

QObject *exclusivePointGrabber() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Dokumentation zu den Mitgliedsfunktionen

[protected delete] QSinglePointEvent::QSinglePointEvent(QSinglePointEvent &&)

Erstellt eine Instanz von ` QSinglePointEvent`. Diese Funktion wurde gelöscht.

Qt::MouseButton QSinglePointEvent::button() const

Gibt die Schaltfläche zurück, die das Ereignis ausgelöst hat.

Der Rückgabewert ist bei Mausbewegungsereignissen sowie bei den Ereignissen „ TabletMove “, „ TabletEnterProximity “ und „ TabletLeaveProximity “ immer „ Qt::NoButton “.

Siehe auch „ buttons()“.

Qt::MouseButtons QSinglePointEvent::buttons() const

Gibt den Status der Schaltfläche zum Zeitpunkt der Ereignisauslösung zurück.

Der Schaltflächenzustand ist eine Kombination aus „ Qt::LeftButton “, „ Qt::RightButton “ und „ Qt::MiddleButton “ unter Verwendung des OR-Operators.

Bei Mausbewegungs- oder „ TabletMove “-Ereignissen sind dies alle Tasten, die gedrückt sind.

Bei Mausklick-, Doppelklick- oder „ TabletPress “-Ereignissen umfasst dies die Taste, die das Ereignis ausgelöst hat.

Bei Mausloslass- oder „ TabletRelease “-Ereignissen ist die Taste, die das Ereignis ausgelöst hat, davon ausgenommen.

Siehe auch ` button()`.

QPointF QSinglePointEvent::globalPosition() const

Gibt die Position des Punktes dieses Ereignisses auf dem Bildschirm oder dem virtuellen Desktop zurück.

Hinweis: Die globale Position eines Mauszeigers wird zum Zeitpunkt des Ereignisses erfasst. Dies ist bei asynchronen Fenstersystemen wie X11 wichtig; wann immer Sie Ihre Widgets als Reaktion auf Mausereignisse verschieben, kann sich globalPosition() erheblich von der aktuellen Cursorposition unterscheiden, die von QCursor::pos() zurückgegeben wird.

Siehe auch ` position()`.

[override virtual] bool QSinglePointEvent::isBeginEvent() const

Gibt „ true “ zurück, wenn dieses Ereignis das Drücken der Taste „ button “ darstellt.

[override virtual] bool QSinglePointEvent::isEndEvent() const

Gibt „ true “ zurück, wenn dieses Ereignis das Freigeben eines „ button “ darstellt.

[override virtual] bool QSinglePointEvent::isUpdateEvent() const

Gibt „ true “ zurück, wenn dieses Ereignis keine Änderung von „ button state “ beinhaltet.

QPointF QSinglePointEvent::position() const

Gibt die Position des Punktes in diesem Ereignis relativ zu dem Widget oder Element zurück, das das Ereignis empfangen hat.

Wenn Sie Ihre Widgets als Reaktion auf Mausereignisse verschieben, verwenden Sie stattdessen ` globalPosition()`.

Siehe auch ` globalPosition()`.

QPointF QSinglePointEvent::scenePosition() const

Gibt die Position des Punktes in diesem Ereignis relativ zum Fenster oder zur Szene zurück.

Siehe auch „ QEventPoint::scenePosition “.

[protected delete] QSinglePointEvent &QSinglePointEvent::operator=(QSinglePointEvent &&)

Weist „ other “ dieser „ QSinglePointEvent “-Instanz zu. Diese Funktion wird gelöscht.

[noexcept protected default] QSinglePointEvent &QSinglePointEvent::operator=(const QSinglePointEvent &other)

other Weist dieser Instanz von „ QSinglePointEvent “ den Wert „ “ zu. “ zu dieser Instanz von „ “ zu.

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