QSinglePointEvent Class

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

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

QEnterEvent, QHoverEvent, QMouseEvent, QNativeGestureEvent, QTabletEvent, und 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)

Reimplementierte öffentliche Funktionen

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

Detaillierte Beschreibung

Dokumentation der Eigenschaften

exclusivePointGrabber : QObject*

Diese Eigenschaft enthält das Objekt, das künftige Aktualisierungen erhalten wird

Der exklusive Grabber ist ein Objekt, das alle zukünftigen Aktualisierungsereignisse und das Freigabeereignis, das denselben Punkt enthält, den dieses Ereignis trägt, erhalten soll.

Das Einstellen der Eigenschaft exclusivePointGrabber entspricht einer praktischen Funktion:

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

Zugriffsfunktionen:

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

Dokumentation der Mitgliedsfunktionen

Qt::MouseButton QSinglePointEvent::button() const

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

Der zurückgegebene Wert ist immer Qt::NoButton für Mausbewegungsereignisse sowie TabletMove, TabletEnterProximity und TabletLeaveProximity Ereignisse.

Siehe auch buttons().

Qt::MouseButtons QSinglePointEvent::buttons() const

Gibt den Zustand der Schaltfläche zurück, als das Ereignis erzeugt wurde.

Der Tastenzustand 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 wurden.

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

Bei Ereignissen zum Loslassen der Maus oder TabletRelease wird die Taste, die das Ereignis ausgelöst hat, ausgeschlossen.

Siehe auch button().

QPointF QSinglePointEvent::globalPosition() const

Gibt die Position des Punktes in diesem Ereignis auf dem Bildschirm oder dem virtuellen Desktop zurück.

Hinweis: Die globale Position eines Mauszeigers wird zum Zeitpunkt des Ereignisses aufgezeichnet. Dies ist auf asynchronen Fenstersystemen wie X11 wichtig; wenn Sie Ihre Widgets als Reaktion auf Mausereignisse verschieben, kann globalPosition() stark von der aktuellen Mauszeigerposition abweichen, die von QCursor::pos() zurückgegeben wird.

Siehe auch position().

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

Gibt true zurück, wenn dieses Ereignis ein button darstellt, das gedrückt wird.

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

Gibt true zurück, wenn dieses Ereignis ein button darstellt, das freigegeben wurde.

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

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

QPointF QSinglePointEvent::position() const

Gibt die Position des Punktes in diesem Ereignis zurück, relativ zu dem Widget oder Element, 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 zurück, relativ zum Fenster oder zur Szene.

Siehe auch QEventPoint::scenePosition.

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