QEventPoint Class
Die Klasse „QEventPoint“ liefert Informationen zu einem Punkt in einem „ QPointerEvent “. Mehr dazu...
| Header: | #include <QEventPoint> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Seit: | Qt 6.0 |
Öffentliche Typen
Eigenschaften
|
|
Öffentliche Funktionen
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(QEventPoint &&other) | |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| QEventPoint & | operator=(QEventPoint &&other) |
| QEventPoint & | operator=(const QEventPoint &other) |
| bool | operator==(const QEventPoint &other) const |
Dokumentation zu den Mitgliedstypen
enum QEventPoint::State
flags QEventPoint::States
Gibt den Status dieses Ereignispunkts an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | Unbekannter Status. |
QEventPoint::Stationary | Qt::TouchPointStationary | Der Ereignispunkt hat sich nicht bewegt. |
QEventPoint::Pressed | Qt::TouchPointPressed | Der Berührungspunkt oder die Schaltfläche wurde gedrückt. |
QEventPoint::Updated | Qt::TouchPointMoved | Der Ereignispunkt wurde aktualisiert. |
QEventPoint::Released | Qt::TouchPointReleased | Der Berührungspunkt oder die Schaltfläche wurde losgelassen. |
Der Typ „States“ ist ein typedef für QFlags<State>. Er speichert eine ODER-Kombination von State-Werten.
Dokumentation der Eigenschaften
accepted : bool
Diese Eigenschaft enthält den Status „akzeptiert“ des Ereignispunkts.
In Widget-basierten Anwendungen wird diese Eigenschaft nicht verwendet, da es für ein Widget nur sinnvoll ist, ein vollständiges „ QInputEvent “ anzunehmen oder abzulehnen.
In „ Qt Quick “ ist es jedoch üblich, dass ein Element oder ein Ereignis-Handler nur die einzelnen Punkte eines „ QTouchEvent “ akzeptiert, die tatsächlich an einer Geste beteiligt sind, während andere Punkte an andere Elemente oder Handler weitergeleitet werden können. Aus Gründen der Konsistenz gilt dies für jedes „ QPointerEvent “; die Weiterleitung erfolgt erst, wenn alle Punkte eines „ QPointerEvent “ akzeptiert wurden.
Zugriffsfunktionen:
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
Siehe auch „ QEvent::accepted “.
[read-only] device : const QPointingDevice*
Diese Eigenschaft enthält das Zeigegerät, von dem dieses Ereignis stammt.
Zugriffsfunktionen:
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Diese Eigenschaft enthält die Breite und Höhe der Begrenzungsellipse des Berührungspunkts.
Der Rückgabewert wird in logischen Pixeln angegeben. Die meisten Touchscreens erkennen die Form des Kontaktpunkts nicht, und auch Mäuse oder Grafiktabletts sind dazu nicht in der Lage, sodass der Wert „null“ am häufigsten vorkommt. Bei einigen Touchscreens können die Durchmesser ungleich Null und immer gleich sein (die Ellipse wird als Kreis approximiert).
Zugriffsfunktionen:
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
Diese Eigenschaft enthält die globale Position, an der dieser Punkt erfasst wurde.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalGrabPosition() const |
Siehe auch globalPosition, grabPosition und sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Diese Eigenschaft enthält die globale Position dieses Punktes aus dem vorherigen Klick- oder Verschiebungsereignis.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalLastPosition() const |
Siehe auch „ globalPosition “, „ lastPosition “ und „ sceneLastPosition “.
[read-only] globalPosition : const QPointF
Diese Eigenschaft enthält die globale Position dieses Punktes.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalPosition() const |
Siehe auch „ globalPressPosition “, „ position “ und „ scenePosition “.
[read-only] globalPressPosition : const QPointF
Diese Eigenschaft enthält die globale Position, an der dieser Punkt angeklickt wurde.
Die globale Position bezieht sich auf den Bildschirm oder den virtuellen Desktop.
Zugriffsfunktionen:
| QPointF | globalPressPosition() const |
Siehe auch „ globalPosition “, „ pressPosition “ und „ scenePressPosition “.
[read-only] grabPosition : const QPointF
Diese Eigenschaft enthält die Position, an der dieser Punkt erfasst wurde.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | grabPosition() const |
Siehe auch „ position “.
[read-only] id : const int
Diese Eigenschaft enthält die ID-Nummer dieses Ereignispunkts.
Hinweis: Gehen Sie nicht davon aus, dass ID-Nummern bei Null beginnen oder fortlaufend sind. Eine solche Annahme ist aufgrund der Funktionsweise der zugrunde liegenden Treiber oft falsch.
Zugriffsfunktionen:
| int | id() const |
[read-only] lastPosition : const QPointF
Diese Eigenschaft enthält die Position dieses Punktes aus dem letzten Klick- oder Verschiebungsereignis.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | lastPosition() const |
Siehe auch „ position “ und „ pressPosition “.
[read-only] lastTimestamp : const ulong
Diese Eigenschaft enthält den Zeitpunkt aus dem vorherigen „ QPointerEvent “, der diesen Punkt enthielt.
Zugriffsfunktionen:
| ulong | lastTimestamp() const |
Siehe auch „ globalLastPosition “.
[read-only] position : const QPointF
Diese Eigenschaft enthält die Position dieses Punktes.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | position() const |
[read-only] pressPosition : const QPointF
Diese Eigenschaft enthält die Position, an der dieser Punkt gedrückt wurde.
Die Position ist relativ zu dem Widget oder Element, das das Ereignis empfangen hat.
Zugriffsfunktionen:
| QPointF | pressPosition() const |
Siehe auch „ position “.
[read-only] pressTimestamp : const ulong
Diese Eigenschaft enthält den Zeitpunkt, zu dem dieser Punkt zuletzt gedrückt wurde.
Zugriffsfunktionen:
| ulong | pressTimestamp() const |
Siehe auch „ timestamp “.
[read-only] pressure : const qreal
Diese Eigenschaft enthält den Druck an diesem Punkt.
Der Rückgabewert liegt im Bereich von 0.0 bis 1.0.
Zugriffsfunktionen:
| qreal | pressure() const |
[read-only] rotation : const qreal
Diese Eigenschaft enthält die Winkelausrichtung dieses Punkts.
Der Rückgabewert wird in Grad angegeben, wobei Null (Standardwert) bedeutet, dass der Finger, das Token oder der Stift nach oben zeigt, ein negativer Winkel bedeutet, dass er nach links gedreht ist, und ein positiver Winkel bedeutet, dass er nach rechts gedreht ist. Die meisten Touchscreens erkennen keine Drehung, daher ist Null der häufigste Wert.
Zugriffsfunktionen:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Diese Eigenschaft enthält die Szenenposition, an der dieser Punkt erfasst wurde.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn das Ereignis in QQuickItem::event() verarbeitet wird, in QGraphicsScene -Koordinaten, wenn es durch eine Überschreibung von QGraphicsItem::touchEvent() verarbeitet wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | sceneGrabPosition() const |
Siehe auch scenePosition, grabPosition und globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Diese Eigenschaft enthält die Szenenposition dieses Punktes aus dem letzten Klick- oder Verschiebungsereignis.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn das Ereignis in QQuickItem::event() verarbeitet wird, in QGraphicsScene -Koordinaten, wenn es durch eine Überschreibung von QGraphicsItem::touchEvent() verarbeitet wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | sceneLastPosition() const |
Siehe auch scenePosition und scenePressPosition.
[read-only] scenePosition : const QPointF
Diese Eigenschaft enthält die Szenenposition dieses Punktes.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn sie in QQuickItem::event() verarbeitet wird, in QGraphicsScene -Koordinaten, wenn sie durch eine Überschreibung von QGraphicsItem::touchEvent() verarbeitet wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | scenePosition() const |
Siehe auch „ scenePressPosition “, „ position “ und „ globalPosition “.
[read-only] scenePressPosition : const QPointF
Diese Eigenschaft enthält die Szenenposition, an der dieser Punkt angeklickt wurde.
Die Szenenposition ist die Position relativ zu QQuickWindow, wenn das Ereignis in QQuickItem::event() verarbeitet wird, in QGraphicsScene -Koordinaten, wenn es durch eine Überschreibung von QGraphicsItem::touchEvent() verarbeitet wird, oder die Fensterposition in Widget-Anwendungen.
Zugriffsfunktionen:
| QPointF | scenePressPosition() const |
Siehe auch scenePosition, pressPosition und globalPressPosition.
[read-only] state : const State
Diese Eigenschaft enthält den aktuellen Status des Ereignispunkts.
Zugriffsfunktionen:
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
Diese Eigenschaft gibt die Dauer in Sekunden an, die seit dem Drücken dieser Taste und bis zum Loslassen vergangen ist.
Zugriffsfunktionen:
| qreal | timeHeld() const |
Siehe auch pressTimestamp und timestamp.
[read-only] timestamp : const ulong
Diese Eigenschaft enthält den letzten Zeitpunkt, zu dem dieser Punkt in einem „ QPointerEvent “ enthalten war.
Zugriffsfunktionen:
| ulong | timestamp() const |
Siehe auch ` QPointerEvent::timestamp()`.
[read-only] uniqueId : const QPointingDeviceUniqueId
Diese Eigenschaft enthält die eindeutige ID dieses Punktes oder Tokens, sofern vorhanden.
Sie ist oft ungültig (siehe isValid()), da Touchscreens Finger nicht eindeutig identifizieren können.
Wenn sie von einem QTabletEvent stammt, gibt sie die Seriennummer des verwendeten Stifts an.
Sie kann ein bestimmtes Token (Referenzobjekt) identifizieren, wenn der TUIO-Treiber mit einem Touchscreen verwendet wird, der diese unterstützt.
Zugriffsfunktionen:
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
Diese Eigenschaft enthält einen Geschwindigkeitsvektor in der Einheit Pixel pro Sekunde im Koordinatensystem des Bildschirms oder des Desktops.
Hinweis: Wenn das Gerät über die Funktion „ QInputDevice::Velocity “ verfügt, bedeutet dies, dass die Geschwindigkeit vom Betriebssystem bereitgestellt wird (möglicherweise wird sie von der Touch-Hardware oder dem Treiber bereitgestellt). In der Regel ist die Funktion „ Velocity “ jedoch nicht gesetzt, was darauf hindeutet, dass die Geschwindigkeit von Qt berechnet wird, wobei ein einfacher Kalman-Filter verwendet wird, um eine geglättete Durchschnittsgeschwindigkeit anstelle eines Momentanwerts zu liefern. Im Grunde gibt sie an, wie schnell und in welche Richtung der Benutzer diesen Punkt während der letzten paar Ereignisse gezogen hat, wobei das jüngste Ereignis den stärksten Einfluss hat.
Zugriffsfunktionen:
| QVector2D | velocity() const |
Siehe auch „ QInputDevice::capabilities()“ und „ QInputEvent::device()“.
Dokumentation der Mitgliedsfunktionen
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Erstellt einen Ereignispunkt mit den angegebenen Werten „ pointId “, „ state “, „ scenePosition “ und „ globalPosition “.
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
Erstellt einen Ereignispunkt, indem eine flache Kopie von ` other` erstellt wird.
[constexpr noexcept default] QEventPoint::QEventPoint(QEventPoint &&other)
Erstellt einen Ereignispunkt, indem „ other “ verschoben wird.
[noexcept] QEventPoint::~QEventPoint()
Löscht den Ereignispunkt.
QPointF QEventPoint::normalizedPosition() const
Gibt die normierte Position dieses Punktes zurück.
Die Koordinaten werden berechnet, indem globalPosition() in den Raum von QInputDevice::availableVirtualGeometry() transformiert wird, d. h. (0, 0) ist die obere linke Ecke und (1, 1) ist die untere rechte Ecke.
Siehe auch globalPosition.
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
Gibt „ true “ zurück, wenn dieser Ereignispunkt nicht mit „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
Weist dieser Ereignispunktinstanz „ other “ zu.
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Weist diesem Ereignispunkt „ other “ zu und gibt eine Referenz auf diesen Ereignispunkt zurück.
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
Gibt „ true “ zurück, wenn dieser Ereignispunkt mit „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
© 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.
